method

Archive.files

glob?: string | readonly string[]

): Promise<Map<string, File>>;

Get the archive contents as a Map of File objects.

Each file in the archive is returned as a File object with:

name: The file path within the archive
lastModified: The file's modification time from the archive
Standard Blob methods (text(), arrayBuffer(), stream(), etc.)

Only regular files are included; directories are not returned. File contents are loaded into memory, so for large archives consider using extract() instead.

@param glob

Optional glob pattern(s) to filter files. Supports the same syntax as Bun.Glob, including negation patterns (prefixed with !). Patterns are matched against paths normalized to use forward slashes (/).

@returns

A promise that resolves with a Map where keys are file paths (always using forward slashes / as separators) and values are File objects

Get all files:

const entries = await archive.files();
for (const [path, file] of entries) {
  console.log(`${path}: ${file.size} bytes`);
}

Referenced types

class File

Provides information about files and allows JavaScript in a web page to access their content.

MDN Reference

readonly lastModified: number
MDN Reference
readonly name: string
MDN Reference
readonly size: number
MDN Reference
readonly type: string
MDN Reference
readonly webkitRelativePath: string
MDN Reference
arrayBuffer(): Promise<ArrayBuffer>;
Returns a promise that resolves to the contents of the blob as an ArrayBuffer
bytes(): Promise<Uint8Array<ArrayBufferLike>>;
MDN Reference
bytes(): Promise<Uint8Array<ArrayBuffer>>;
Returns a promise that resolves to the contents of the blob as a Uint8Array (array of bytes) its the same as new Uint8Array(await blob.arrayBuffer())
formData(): Promise<FormData>;
Read the data from the blob as a FormData object.
This first decodes the data from UTF-8, then parses it as a multipart/form-data body or a application/x-www-form-urlencoded body.
The type property of the blob is used to determine the format of the body.
This is a non-standard addition to the Blob API, to make it conform more closely to the BodyMixin API.
json(): Promise<any>;
Read the data from the blob as a JSON object.
This first decodes the data from UTF-8, then parses it as JSON.
slice(
start?: number,
end?: number,
contentType?: string
): Blob;
MDN Reference
stream(): ReadableStream<Uint8Array<ArrayBufferLike>>;
MDN Reference
stream(): ReadableStream<Uint8Array<ArrayBuffer>>;
Returns a readable stream of the blob's contents
text(): Promise<string>;
Returns a promise that resolves to the contents of the blob as a string