Class ZipFS<TBuffer>

A file system backend by a zip file. Implemented according to the standard: http://pkware.com/documents/casestudies/APPNOTE.TXT

While there are a few zip libraries for JavaScript (e.g. JSZip and zip.js), they are not a good match for ZenFS. In particular, these libraries perform a lot of unneeded data copying, and eagerly decompress every file in the zip file upon loading to check the CRC32. They also eagerly decode strings. Furthermore, these libraries duplicate functionality already present in ZenFS (e.g. UTF-8 decoding and binary data manipulation).

When the filesystem is instantiated, we determine the directory structure of the zip file as quickly as possible. We lazily decompress and check the CRC32 of files.

Current limitations:

No encryption.
No ZIP64 support.
Read-only. Write support would require that we:
- Keep track of changed/new files.
- Compress changed files, and generate appropriate metadata for each.
- Update file offsets for other files in the zip file.
- Stream it out to a location. This isn't that bad, so we might do this at a later date.

Type Parameters

TBuffer extends ArrayBufferLike = ArrayBuffer

Hierarchy

ReadonlyMixin & AsyncFSMethods<this> & FileSystem<this>
- ZipFS

Index

Constructors

constructor

new ZipFS<TBuffer extends ArrayBufferLike = ArrayBuffer>(
label: string,
data: Uint8Array<TBuffer>,
): ZipFS<TBuffer>
Type Parameters
- TBuffer extends ArrayBufferLike = ArrayBuffer
Parameters
- label: string
- data: Uint8Array<TBuffer>
Returns ZipFS<TBuffer>
Overrides Readonly(Sync(FileSystem)).constructor
- Defined in src/zip/fs.ts:67

Properties

`Protected` `Optional` `Internal`_mountPoint

_mountPoint?: string

The last place this file system was mounted

`Protected`_time

_time: number = ...

`Protected` `Internal`_uuid

_uuid: `${string}-${string}-${string}-${string}-${string}`

The UUID of the file system.

`Readonly`attributes

attributes: ConstMap<
    FileSystemAttributes,
    keyof FileSystemAttributes,
    undefined
    | void
    | CaseFold,
> & Map<string, any>

See

FileSystemAttributes

`Protected`data

data: Uint8Array<TBuffer>

`Protected`directories

directories: Map<string, Set<string>> = ...

`Protected` `Readonly`eocd

eocd: Header<TBuffer>

`Protected`files

files: Map<string, FileEntry<TBuffer>> = ...

label

label: string

`Readonly`name

name: string

The name for this file system. For example, tmpfs for an in memory one

`Readonly`type

type: number

A unique ID for this kind of file system. Currently unused internally, but could be used for partition tables or something

Accessors

uuid

get uuid(): `${string}-${string}-${string}-${string}-${string}`
Returns `${string}-${string}-${string}-${string}-${string}`
Inherited from Readonly(Sync(FileSystem)).uuid
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:149

Methods

createFile

createFile(path: string, flag: string, mode: number): Promise<never>
Parameters
- path: string
- flag: string
- mode: number
Returns Promise<never>
Inherited from Readonly(Sync(FileSystem)).createFile
- Defined in node_modules/@zenfs/core/dist/mixins/readonly.d.ts:10
createFile(path: string, options: CreationOptions): Promise<InodeLike>
Create the file at path with the given options.
Parameters
- path: string
- options: CreationOptions
Returns Promise<InodeLike>
Inherited from Readonly(Sync(FileSystem)).createFile
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:184

createFileSync

createFileSync(path: string, flag: string, mode: number): never
Parameters
- path: string
- flag: string
- mode: number
Returns never
Inherited from Readonly(Sync(FileSystem)).createFileSync
- Defined in node_modules/@zenfs/core/dist/mixins/readonly.d.ts:11
createFileSync(path: string, options: CreationOptions): InodeLike
Create the file at path with the given options.
Parameters
- path: string
- options: CreationOptions
Returns InodeLike
Inherited from Readonly(Sync(FileSystem)).createFileSync
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:188

exists

exists(path: string): Promise<boolean>
Test whether or not path exists.
Parameters
- path: string
Returns Promise<boolean>
Inherited from Readonly(Sync(FileSystem)).exists
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:200

existsSync

existsSync(path: string): boolean
Test whether or not path exists.
Parameters
- path: string
Returns boolean
Inherited from Readonly(Sync(FileSystem)).existsSync
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:204

link

link(srcpath: string, dstpath: string): Promise<never>
Parameters
- srcpath: string
- dstpath: string
Returns Promise<never>
Inherited from Readonly(Sync(FileSystem)).link
- Defined in node_modules/@zenfs/core/dist/mixins/readonly.d.ts:18
link(target: string, link: string): Promise<void>
Parameters
- target: string
- link: string
Returns Promise<void>
Inherited from Readonly(Sync(FileSystem)).link
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:205

linkSync

linkSync(srcpath: string, dstpath: string): never
Parameters
- srcpath: string
- dstpath: string
Returns never
Inherited from Readonly(Sync(FileSystem)).linkSync
- Defined in node_modules/@zenfs/core/dist/mixins/readonly.d.ts:19
linkSync(target: string, link: string): void
Parameters
- target: string
- link: string
Returns void
Inherited from Readonly(Sync(FileSystem)).linkSync
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:206

mkdir

mkdir(path: string, mode: number): Promise<never>
Parameters
- path: string
- mode: number
Returns Promise<never>
Inherited from Readonly(Sync(FileSystem)).mkdir
- Defined in node_modules/@zenfs/core/dist/mixins/readonly.d.ts:16
mkdir(path: string, options: CreationOptions): Promise<InodeLike>
Parameters
- path: string
- options: CreationOptions
Returns Promise<InodeLike>
Inherited from Readonly(Sync(FileSystem)).mkdir
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:193

mkdirSync

mkdirSync(path: string, mode: number): never
Parameters
- path: string
- mode: number
Returns never
Inherited from Readonly(Sync(FileSystem)).mkdirSync
- Defined in node_modules/@zenfs/core/dist/mixins/readonly.d.ts:17
mkdirSync(path: string, options: CreationOptions): InodeLike
Parameters
- path: string
- options: CreationOptions
Returns InodeLike
Inherited from Readonly(Sync(FileSystem)).mkdirSync
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:194

`Abstract`read

read(
    path: string,
    buffer: Uint8Array,
    start: number,
    end: number,
): Promise<void>
Reads into a buffer
Parameters
- path: string
- buffer: Uint8Array
  The buffer to read into. You must set the byteOffset and byteLength appropriately!
- start: number
  The offset into the file to start reading from
- end: number
  The position in the file to stop reading
Returns Promise<void>
Inherited from Readonly(Sync(FileSystem)).read
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:215

`Abstract`readdir

readdir(path: string): Promise<string[]>
Parameters
- path: string
Returns Promise<string[]>
Inherited from Readonly(Sync(FileSystem)).readdir
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:195

readdirSync

readdirSync(path: string): string[]
Parameters
- path: string
Returns string[]
Overrides Readonly(Sync(FileSystem)).readdirSync
- Defined in src/zip/fs.ts:151

readSync

readSync(path: string, buffer: Uint8Array, offset: number, end: number): void
Reads into a buffer
Parameters
- path: string
- buffer: Uint8Array
  The buffer to read into. You must set the byteOffset and byteLength appropriately!
- offset: number
- end: number
  The position in the file to stop reading
Returns void
Overrides Readonly(Sync(FileSystem)).readSync
- Defined in src/zip/fs.ts:163

ready

ready(): Promise<void>
Returns Promise<void>
Inherited from Readonly(Sync(FileSystem)).ready
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:172

rename

rename(oldPath: string, newPath: string): Promise<never>
Parameters
- oldPath: string
- newPath: string
Returns Promise<never>
Inherited from Readonly(Sync(FileSystem)).rename
- Defined in node_modules/@zenfs/core/dist/mixins/readonly.d.ts:8
rename(oldPath: string, newPath: string): Promise<void>
Parameters
- oldPath: string
- newPath: string
Returns Promise<void>
Inherited from Readonly(Sync(FileSystem)).rename
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:173

renameSync

renameSync(oldPath: string, newPath: string): never
Parameters
- oldPath: string
- newPath: string
Returns never
Inherited from Readonly(Sync(FileSystem)).renameSync
- Defined in node_modules/@zenfs/core/dist/mixins/readonly.d.ts:9
renameSync(oldPath: string, newPath: string): void
Parameters
- oldPath: string
- newPath: string
Returns void
Inherited from Readonly(Sync(FileSystem)).renameSync
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:174

rmdir

rmdir(path: string): Promise<never>
Parameters
- path: string
Returns Promise<never>
Inherited from Readonly(Sync(FileSystem)).rmdir
- Defined in node_modules/@zenfs/core/dist/mixins/readonly.d.ts:14
rmdir(path: string): Promise<void>
Parameters
- path: string
Returns Promise<void>
Inherited from Readonly(Sync(FileSystem)).rmdir
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:191

rmdirSync

rmdirSync(path: string): never
Parameters
- path: string
Returns never
Inherited from Readonly(Sync(FileSystem)).rmdirSync
- Defined in node_modules/@zenfs/core/dist/mixins/readonly.d.ts:15
rmdirSync(path: string): void
Parameters
- path: string
Returns void
Inherited from Readonly(Sync(FileSystem)).rmdirSync
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:192

`Abstract`stat

stat(path: string): Promise<InodeLike>
Parameters
- path: string
Returns Promise<InodeLike>
Inherited from Readonly(Sync(FileSystem)).stat
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:175

statSync

statSync(path: string): Inode
Parameters
- path: string
Returns Inode
Overrides Readonly(Sync(FileSystem)).statSync
- Defined in src/zip/fs.ts:131

streamRead

streamRead(path: string, options: StreamOptions): ReadableStream
Read a file using a stream.
Parameters
- path: string
- options: StreamOptions
Returns ReadableStream
Inherited from Readonly(Sync(FileSystem)).streamRead
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:239

streamWrite

streamWrite(path: string, options: StreamOptions): WritableStream
Write a file using stream.
Parameters
- path: string
- options: StreamOptions
Returns WritableStream
Inherited from Readonly(Sync(FileSystem)).streamWrite
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:244

sync

sync(): Promise<never>
Returns Promise<never>
Inherited from Readonly(Sync(FileSystem)).sync
- Defined in node_modules/@zenfs/core/dist/mixins/readonly.d.ts:22
sync(): Promise<void>
Returns Promise<void>
Inherited from Readonly(Sync(FileSystem)).sync
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:207

syncSync

syncSync(): never
Returns never
Inherited from Readonly(Sync(FileSystem)).syncSync
- Defined in node_modules/@zenfs/core/dist/mixins/readonly.d.ts:23
syncSync(): void
Returns void
Inherited from Readonly(Sync(FileSystem)).syncSync
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:208

toString

toString(): string
Returns string
Inherited from Readonly(Sync(FileSystem)).toString
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:165

touch

touch(path: string, metadata: Readonly<InodeLike>): Promise<never>
Parameters
- path: string
- metadata: Readonly<InodeLike>
Returns Promise<never>
Inherited from Readonly(Sync(FileSystem)).touch
- Defined in node_modules/@zenfs/core/dist/mixins/readonly.d.ts:20
touch(path: string, metadata: Partial<InodeLike>): Promise<void>
Modify metadata.
Parameters
- path: string
- metadata: Partial<InodeLike>
Returns Promise<void>
Inherited from Readonly(Sync(FileSystem)).touch
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:178

touchSync

touchSync(path: string, metadata: Readonly<InodeLike>): never
Parameters
- path: string
- metadata: Readonly<InodeLike>
Returns never
Inherited from Readonly(Sync(FileSystem)).touchSync
- Defined in node_modules/@zenfs/core/dist/mixins/readonly.d.ts:21
touchSync(path: string, metadata: Partial<InodeLike>): void
Modify metadata.
Parameters
- path: string
- metadata: Partial<InodeLike>
Returns void
Inherited from Readonly(Sync(FileSystem)).touchSync
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:180

unlink

unlink(path: string): Promise<never>
Parameters
- path: string
Returns Promise<never>
Inherited from Readonly(Sync(FileSystem)).unlink
- Defined in node_modules/@zenfs/core/dist/mixins/readonly.d.ts:12
unlink(path: string): Promise<void>
Parameters
- path: string
Returns Promise<void>
Inherited from Readonly(Sync(FileSystem)).unlink
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:189

unlinkSync

unlinkSync(path: string): never
Parameters
- path: string
Returns never
Inherited from Readonly(Sync(FileSystem)).unlinkSync
- Defined in node_modules/@zenfs/core/dist/mixins/readonly.d.ts:13
unlinkSync(path: string): void
Parameters
- path: string
Returns void
Inherited from Readonly(Sync(FileSystem)).unlinkSync
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:190

usage

usage(): UsageInfo
Experimental
Default implementation.

Returns UsageInfo
Todo
Implement
Overrides Readonly(Sync(FileSystem)).usage
- Defined in src/zip/fs.ts:124

write

write(path: string, buffer: Uint8Array, offset: number): Promise<never>
Parameters
- path: string
- buffer: Uint8Array
- offset: number
Returns Promise<never>
Inherited from Readonly(Sync(FileSystem)).write
- Defined in node_modules/@zenfs/core/dist/mixins/readonly.d.ts:24
write(path: string, buffer: Uint8Array, offset: number): Promise<void>
Writes a buffer to a file
Parameters
- path: string
- buffer: Uint8Array
  The buffer to write. You must set the byteOffset and byteLength appropriately!
- offset: number
  The offset in the file to start writing
Returns Promise<void>
Inherited from Readonly(Sync(FileSystem)).write
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:228

writeSync

writeSync(path: string, buffer: Uint8Array, offset: number): never
Parameters
- path: string
- buffer: Uint8Array
- offset: number
Returns never
Inherited from Readonly(Sync(FileSystem)).writeSync
- Defined in node_modules/@zenfs/core/dist/mixins/readonly.d.ts:25
writeSync(path: string, buffer: Uint8Array, offset: number): void
Writes a buffer to a file
Parameters
- path: string
- buffer: Uint8Array
  The buffer to write. You must set the byteOffset and byteLength appropriately!
- offset: number
  The offset in the file to start writing
Returns void
Inherited from Readonly(Sync(FileSystem)).writeSync
- Defined in node_modules/@zenfs/core/dist/internal/filesystem.d.ts:234

Class ZipFS<TBuffer>

Type Parameters

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Type Parameters

Parameters

Returns ZipFS<TBuffer>

Properties

Protected Optional Internal_mountPoint

Protected_time

Protected Internal_uuid

Readonlyattributes

See

Protecteddata

Protecteddirectories

Protected Readonlyeocd

Protectedfiles

label

Readonlyname

Readonlytype

Accessors

uuid

Returns `${string}-${string}-${string}-${string}-${string}`

Methods

createFile

Parameters

Returns Promise<never>

Parameters

Returns Promise<InodeLike>

createFileSync

Parameters

Returns never

Parameters

Returns InodeLike

exists

Parameters

Returns Promise<boolean>

existsSync

Parameters

Returns boolean

link

Parameters

Returns Promise<never>

Parameters

Returns Promise<void>

linkSync

Parameters

Returns never

Parameters

Returns void

mkdir

Parameters

Returns Promise<never>

Parameters

Returns Promise<InodeLike>

mkdirSync

Parameters

Returns never

Parameters

Returns InodeLike

Abstractread

Parameters

Returns Promise<void>

Abstractreaddir

Parameters

Returns Promise<string[]>

readdirSync

Parameters

Returns string[]

readSync

Parameters

Returns void

ready

Returns Promise<void>

`Protected` `Optional` `Internal`_mountPoint

`Protected`_time

`Protected` `Internal`_uuid

`Readonly`attributes

`Protected`data

`Protected`directories

`Protected` `Readonly`eocd

`Protected`files

`Readonly`name

`Readonly`type

`Abstract`read

`Abstract`readdir

`Abstract`stat