Browser-stream-tar NPM

browser-stream-tar

split tar web-stream into a sequence of Files

example

import { files } from "browser-stream-tar";

const response = await fetch("some tar file");
for await (const file of files(response.body)) {
  console.log(file.name);
  // do something with entry.stream()
}

API

BLOCKSIZE

Field Name Byte Offset Length in Bytes Field Type name 0 100 NUL-terminated if NUL fits mode 100 8 uid 108 8 gid 116 8 size 124 12 mtime 136 12 chksum 148 8 typeflag 156 1 see below linkname 157 100 NUL-terminated if NUL fits magic 257 6 must be TMAGIC (NUL term.) version 263 2 must be TVERSION uname 265 32 NUL-terminated gname 297 32 NUL-terminated devmajor 329 8 devminor 337 8 prefix 345 155 NUL-terminated if NUL fits

Type: number

File

Type: Object

Properties

name string
size number
mode number
uname string
gname string
uid number
gid number
lastModified Date
stream ReadableStream ()

decodePaxHeader

See: https://www.systutorials.com/docs/linux/man/5-star/

Decodes a PAX header

Parameters

reader ReadableStreamReader where to read from
buffer Uint8Array
file Object to be filled with values form buffer

Returns Promise [Uint8Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array) buffer positioned after the consumed bytes

decodeHeader

Decodes the next header.

Parameters

reader ReadableStreamReader[Uint8Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array) where to read from
buffer (Uint8Array | undefined)
file Object to be filled with values form buffer and reader

Returns Promise<(Uint8Array | undefined)> buffer positioned after the consumed bytes

files

Provide tar entries as Files.

Parameters

tar ReadableStream

Returns AsyncIterator<File>

enqueue

--512--|-----512------| | R | O | | DDDDDDDDDDDD---------HHHH | | | A0 A0 A1

buffer

+--------- size --------+ | +- remaining -+- overflow -+ | | | | HDD ... DDDDDDDDDDDDDDDDDD------------HHHHHH [BUFFER .... ] [BUFFER ... ] +----------- skip --------+