WorkerFS | BrowserFS

WorkerFS lets you access a BrowserFS instance that is running in a different JavaScript context (e.g. access BrowserFS in one of your WebWorkers, or access BrowserFS running on the main page from a WebWorker).

For example, to have a WebWorker access files in the main browser thread, do the following:

MAIN BROWSER THREAD:

  // Listen for remote file system requests.
  BrowserFS.FileSystem.WorkerFS.attachRemoteListener(webWorkerObject);

WEBWORKER THREAD:

  // Set the remote file system as the root file system.
  BrowserFS.initialize(new BrowserFS.FileSystem.WorkerFS(self));

Note that synchronous operations are not permitted on the WorkerFS, regardless of the configuration option of the remote FS.

Hierarchy

BaseFileSystem
- WorkerFS

Implements

FileSystem

Index

Constructors

constructor

Methods

Constructors

constructor

new WorkerFS(worker: Worker): WorkerFS

- Defined in backend/WorkerFS.ts:662
Constructs a new WorkerFS instance that connects with BrowserFS running on the specified worker.

Parameters
- worker: Worker
Returns WorkerFS

Methods

appendFile

appendFile(fname: string, data: any, encoding: string, flag: FileFlag, mode: number, cb: BFSOneArgCallback): void

Overrides BaseFileSystem.appendFile
- Defined in backend/WorkerFS.ts:753
Parameters
- fname: string
- data: any
- encoding: string
- flag: FileFlag
- mode: number
- cb: BFSOneArgCallback
Returns void

appendFileSync

appendFileSync(fname: string, data: any, encoding: string | null, flag: FileFlag, mode: number): void

Inherited from BaseFileSystem.appendFileSync
- Defined in core/file_system.ts:707
Parameters
- fname: string
- data: any
- encoding: string | null
- flag: FileFlag
- mode: number
Returns void

chmod

chmod(p: string, isLchmod: boolean, mode: number, cb: Function): void

Overrides BaseFileSystem.chmod
- Defined in backend/WorkerFS.ts:756
Parameters
- p: string
- isLchmod: boolean
- mode: number
- cb: Function
Returns void

chmodSync

chmodSync(p: string, isLchmod: boolean, mode: number): void

Implementation of FileSystem.chmodSync

Inherited from BaseFileSystem.chmodSync
- Defined in core/file_system.ts:721
Parameters
- p: string
- isLchmod: boolean
- mode: number
Returns void

chown

chown(p: string, isLchown: boolean, uid: number, gid: number, cb: Function): void

Overrides BaseFileSystem.chown
- Defined in backend/WorkerFS.ts:759
Parameters
- p: string
- isLchown: boolean
- uid: number
- gid: number
- cb: Function
Returns void

chownSync

chownSync(p: string, isLchown: boolean, uid: number, gid: number): void

Implementation of FileSystem.chownSync

Inherited from BaseFileSystem.chownSync
- Defined in core/file_system.ts:727
Parameters
- p: string
- isLchown: boolean
- uid: number
- gid: number
Returns void

createFile

createFile(p: string, flag: FileFlag, mode: number, cb: BFSCallback): void

Inherited from BaseFileSystem.createFile
- Defined in core/file_system.ts:366
Create the file at path p with the given mode. Then, open it with the given flag.

Parameters
- p: string
- flag: FileFlag
- mode: number
- cb: BFSCallback
Returns void

createFileSync

createFileSync(p: string, flag: FileFlag, mode: number): File

Inherited from BaseFileSystem.createFileSync
- Defined in core/file_system.ts:450
Create the file at path p with the given mode. Then, open it with the given flag.

Parameters
- p: string
- flag: FileFlag
- mode: number
Returns File

diskSpace

diskSpace(p: string, cb: function): void

Inherited from BaseFileSystem.diskSpace
- Defined in core/file_system.ts:351
Parameters
- p: string
- cb: function
  - - (total: number, free: number): any
    - Parameters
      - total: number
      - free: number
      Returns any
Returns void

exists

exists(p: string, cb: function): void

Overrides BaseFileSystem.exists
- Defined in backend/WorkerFS.ts:738
Parameters
- p: string
- cb: function
  - - (exists: boolean): void
    - Parameters
      - exists: boolean
      Returns void
Returns void

existsSync

existsSync(p: string): boolean

Implementation of FileSystem.existsSync

Inherited from BaseFileSystem.existsSync
- Defined in core/file_system.ts:525
Parameters
- p: string
Returns boolean

getName

getName(): string

Implementation of FileSystem.getName
- Defined in backend/WorkerFS.ts:686
Returns string

initialize

initialize(cb: function): void

- Defined in backend/WorkerFS.ts:693
Called once both local and remote sides are set up.

Parameters
- cb: function
  - - (): void
    - Returns void
Returns void

isReadOnly

isReadOnly(): boolean

Implementation of FileSystem.isReadOnly
- Defined in backend/WorkerFS.ts:712
Returns boolean

link

link(srcpath: string, dstpath: string, cb: Function): void

Overrides BaseFileSystem.link
- Defined in backend/WorkerFS.ts:765
Parameters
- srcpath: string
- dstpath: string
- cb: Function
Returns void

linkSync

linkSync(srcpath: string, dstpath: string): void

Implementation of FileSystem.linkSync

Inherited from BaseFileSystem.linkSync
- Defined in core/file_system.ts:739
Parameters
- srcpath: string
- dstpath: string
Returns void

mkdir

mkdir(p: string, mode: number, cb: Function): void

Overrides BaseFileSystem.mkdir
- Defined in backend/WorkerFS.ts:732
Parameters
- p: string
- mode: number
- cb: Function
Returns void

mkdirSync

mkdirSync(p: string, mode: number): void

Implementation of FileSystem.mkdirSync

Inherited from BaseFileSystem.mkdirSync
- Defined in core/file_system.ts:511
Parameters
- p: string
- mode: number
Returns void

open

open(p: string, flag: FileFlag, mode: number, cb: BFSCallback): void

Implementation of FileSystem.open

Overrides BaseFileSystem.open
- Defined in backend/WorkerFS.ts:723
Parameters
- p: string
- flag: FileFlag
- mode: number
- cb: BFSCallback
Returns void

openFile

openFile(p: string, flag: FileFlag, cb: BFSCallback): void

Inherited from BaseFileSystem.openFile
- Defined in core/file_system.ts:359
Opens the file at path p with the given flag. The file must exist.

Parameters
- p: string
  
  The path to open.
- flag: FileFlag
  
  The flag to use when opening the file.
- cb: BFSCallback
Returns void

openFileSync

openFileSync(p: string, flag: FileFlag, mode: number): File

Inherited from BaseFileSystem.openFileSync
- Defined in core/file_system.ts:443
Opens the file at path p with the given flag. The file must exist.

Parameters
- p: string
  
  The path to open.
- flag: FileFlag
  
  The flag to use when opening the file.
- mode: number
Returns File

A File object corresponding to the opened file.

openSync

openSync(p: string, flag: FileFlag, mode: number): File

Implementation of FileSystem.openSync

Inherited from BaseFileSystem.openSync
- Defined in core/file_system.ts:453
Parameters
- p: string
- flag: FileFlag
- mode: number
Returns File

readFile

readFile(fname: string, encoding: string, flag: FileFlag, cb: BFSCallback): void

Overrides BaseFileSystem.readFile
- Defined in backend/WorkerFS.ts:747
Parameters
- fname: string
- encoding: string
- flag: FileFlag
- cb: BFSCallback
Returns void

readFileSync

readFileSync(fname: string, encoding: string | null, flag: FileFlag): any

Implementation of FileSystem.readFileSync

Inherited from BaseFileSystem.readFileSync
- Defined in core/file_system.ts:634
Parameters
- fname: string
- encoding: string | null
- flag: FileFlag
Returns any

readdir

readdir(p: string, cb: BFSCallback): void

Implementation of FileSystem.readdir

Overrides BaseFileSystem.readdir
- Defined in backend/WorkerFS.ts:735
Parameters
- p: string
- cb: BFSCallback
Returns void

readdirSync

readdirSync(p: string): string[]

Implementation of FileSystem.readdirSync

Inherited from BaseFileSystem.readdirSync
- Defined in core/file_system.ts:517
Parameters
- p: string
Returns string[]

readlink

readlink(p: string, cb: Function): void

Overrides BaseFileSystem.readlink
- Defined in backend/WorkerFS.ts:771
Parameters
- p: string
- cb: Function
Returns void

readlinkSync

readlinkSync(p: string): string

Implementation of FileSystem.readlinkSync

Inherited from BaseFileSystem.readlinkSync
- Defined in core/file_system.ts:751
Parameters
- p: string
Returns string

realpath

realpath(p: string, cache: object, cb: BFSCallback): void

Overrides BaseFileSystem.realpath
- Defined in backend/WorkerFS.ts:741
Parameters
- p: string
- cache: object
  - [path: string]: string
- cb: BFSCallback
Returns void

realpathSync

realpathSync(p: string, cache: object): string

Inherited from BaseFileSystem.realpathSync
- Defined in core/file_system.ts:554
Parameters
- p: string
- cache: object
  - [path: string]: string
Returns string

rename

rename(oldPath: string, newPath: string, cb: BFSOneArgCallback): void

Implementation of FileSystem.rename

Overrides BaseFileSystem.rename
- Defined in backend/WorkerFS.ts:717
Parameters
- oldPath: string
- newPath: string
- cb: BFSOneArgCallback
Returns void

renameSync

renameSync(oldPath: string, newPath: string): void

Implementation of FileSystem.renameSync

Inherited from BaseFileSystem.renameSync
- Defined in core/file_system.ts:428
Parameters
- oldPath: string
- newPath: string
Returns void

rmdir

rmdir(p: string, cb: Function): void

Overrides BaseFileSystem.rmdir
- Defined in backend/WorkerFS.ts:729
Parameters
- p: string
- cb: Function
Returns void

rmdirSync

rmdirSync(p: string): void

Implementation of FileSystem.rmdirSync

Inherited from BaseFileSystem.rmdirSync
- Defined in core/file_system.ts:505
Parameters
- p: string
Returns void

stat

stat(p: string, isLstat: boolean, cb: BFSCallback): void

Overrides BaseFileSystem.stat
- Defined in backend/WorkerFS.ts:720
Parameters
- p: string
- isLstat: boolean
- cb: BFSCallback
Returns void

statSync

statSync(p: string, isLstat: boolean | null): Stats

Implementation of FileSystem.statSync

Inherited from BaseFileSystem.statSync
- Defined in core/file_system.ts:434
Parameters
- p: string
- isLstat: boolean | null
Returns Stats

supportsLinks

supportsLinks(): boolean

Implementation of FileSystem.supportsLinks

Overrides BaseFileSystem.supportsLinks
- Defined in backend/WorkerFS.ts:714
Returns boolean

supportsProps

supportsProps(): boolean

Implementation of FileSystem.supportsProps
- Defined in backend/WorkerFS.ts:715
Returns boolean

supportsSynch

supportsSynch(): boolean

Implementation of FileSystem.supportsSynch
- Defined in backend/WorkerFS.ts:713
Returns boolean

symlink

symlink(srcpath: string, dstpath: string, type: string, cb: Function): void

Overrides BaseFileSystem.symlink
- Defined in backend/WorkerFS.ts:768
Parameters
- srcpath: string
- dstpath: string
- type: string
- cb: Function
Returns void

symlinkSync

symlinkSync(srcpath: string, dstpath: string, type: string): void

Implementation of FileSystem.symlinkSync

Inherited from BaseFileSystem.symlinkSync
- Defined in core/file_system.ts:745
Parameters
- srcpath: string
- dstpath: string
- type: string
Returns void

syncClose

syncClose(method: string, fd: File, cb: BFSOneArgCallback): void

- Defined in backend/WorkerFS.ts:775
Parameters
- method: string
- fd: File
- cb: BFSOneArgCallback
Returns void

truncate

truncate(p: string, len: number, cb: Function): void

Overrides BaseFileSystem.truncate
- Defined in backend/WorkerFS.ts:744
Parameters
- p: string
- len: number
- cb: Function
Returns void

truncateSync

truncateSync(p: string, len: number): void

Implementation of FileSystem.truncateSync

Inherited from BaseFileSystem.truncateSync
- Defined in core/file_system.ts:586
Parameters
- p: string
- len: number
Returns void

unlink

unlink(p: string, cb: Function): void

Overrides BaseFileSystem.unlink
- Defined in backend/WorkerFS.ts:726
Parameters
- p: string
- cb: Function
Returns void

unlinkSync

unlinkSync(p: string): void

Implementation of FileSystem.unlinkSync

Inherited from BaseFileSystem.unlinkSync
- Defined in core/file_system.ts:499
Parameters
- p: string
Returns void

utimes

utimes(p: string, atime: Date, mtime: Date, cb: Function): void

Overrides BaseFileSystem.utimes
- Defined in backend/WorkerFS.ts:762
Parameters
- p: string
- atime: Date
- mtime: Date
- cb: Function
Returns void

utimesSync

utimesSync(p: string, atime: Date, mtime: Date): void

Implementation of FileSystem.utimesSync

Inherited from BaseFileSystem.utimesSync
- Defined in core/file_system.ts:733
Parameters
- p: string
- atime: Date
- mtime: Date
Returns void

writeFile

writeFile(fname: string, data: any, encoding: string, flag: FileFlag, mode: number, cb: BFSOneArgCallback): void

Overrides BaseFileSystem.writeFile
- Defined in backend/WorkerFS.ts:750
Parameters
- fname: string
- data: any
- encoding: string
- flag: FileFlag
- mode: number
- cb: BFSOneArgCallback
Returns void

writeFileSync

writeFileSync(fname: string, data: any, encoding: string | null, flag: FileFlag, mode: number): void

Inherited from BaseFileSystem.writeFileSync
- Defined in core/file_system.ts:676
Parameters
- fname: string
- data: any
- encoding: string | null
- flag: FileFlag
- mode: number
Returns void

Static attachRemoteListener

attachRemoteListener(worker: Worker): void

- Defined in backend/WorkerFS.ts:492
Attaches a listener to the remote worker for file system requests.

Parameters
- worker: Worker
Returns void

Static isAvailable

isAvailable(): boolean

- Defined in backend/WorkerFS.ts:485
Returns boolean

Hierarchy

Implements

Index

Constructors

Methods

Constructors

constructor

Parameters

worker: Worker

Returns WorkerFS

Methods

appendFile

Parameters

fname: string

data: any

encoding: string

flag: FileFlag

mode: number

cb: BFSOneArgCallback

Returns void

appendFileSync

Parameters

fname: string

data: any

encoding: string | null

flag: FileFlag

mode: number

Returns void

chmod

Parameters

p: string

isLchmod: boolean

mode: number

cb: Function

Returns void

chmodSync

Parameters

p: string

isLchmod: boolean

mode: number

Returns void

chown

Parameters

p: string

isLchown: boolean

uid: number

gid: number

cb: Function

Returns void

chownSync

Parameters

p: string

isLchown: boolean

uid: number

gid: number

Returns void

createFile

Parameters

p: string

flag: FileFlag

mode: number

cb: BFSCallback

Returns void

createFileSync

Parameters

p: string

flag: FileFlag

mode: number

Returns File

diskSpace

Parameters

p: string

cb: function

Parameters

total: number

free: number

Returns any

Returns void

exists

Parameters