Taildrop class
Node-to-node file transfer ("Taildrop") over the tailnet. Sends travel directly between nodes with no third-party service in the middle — good fit for mobile-to-desktop sync, collab tools, and anywhere you'd otherwise set up a file server.
See tailscale.com/kb/1106/taildrop for the full feature
(send targets, ACL requirements, receive directory semantics on
native Tailscale clients — package:tailscale exposes the same
LocalAPI surface but leaves file persistence to the caller).
Reached via Tailscale.taildrop. Requires the tailnet operator to have Taildrop enabled in ACLs (on by default); targets are filtered to the set the ACLs allow this node to send to.
Properties
- hashCode → int
-
The hash code for this object.
no setterinherited
-
onWaitingFile
→ Stream<
WaitingFile> -
Reactive stream — emits each newly received file as it arrives.
no setter
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
Methods
-
awaitWaitingFiles(
{Duration? timeout}) → Future< List< WaitingFile> > -
Blocks until at least one received file is available, or
timeoutexpires. Returns the same shape as waitingFiles. -
delete(
String name) → Future< void> - Discards a received file without reading it.
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
openRead(
String name) → Stream< Uint8List> - Opens a byte stream over a received file. The caller decides where to persist the contents. Does not delete — call delete once the bytes are durable.
-
push(
{required FileTarget target, required String name, required Stream< Uint8List> data, int? size}) → Future<void> -
Streams
datatotargetundername.sizeis optional but enables progress reporting on the receiver. -
targets(
) → Future< List< FileTarget> > - Nodes you can send files to right now (owned-by-you + online + allowed by ACLs).
-
toString(
) → String -
A string representation of this object.
inherited
-
waitingFiles(
) → Future< List< WaitingFile> > - Files received on this node and not yet picked up.
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited