Interface ZipReaderOptions

true to throw an ERR_AMBIGUOUS_ARCHIVE error when calling FileEntry#getData if the local file header of the entry disagrees with its central directory record in a way that could make other tools (e.g. streaming readers based on local file headers) interpret the entry differently. This detects mismatched filenames, general purpose bit flags (encryption, data descriptor and language encoding flags), compression methods, CRC-32 checksums and sizes. The extra fields are not compared because the zip specification allows them to differ.

This is the boolean form of ZipReaderOptions#strictness: true means "strict" and false means any value but "strict". When both options are set, the value passed to FileEntry#getData takes precedence over the value passed to the constructor of ZipReader, and strictness takes precedence over checkAmbiguity when both are set at the same level. false downgrades an inherited "strict" value to "balanced" and leaves an inherited "tolerant" value unchanged.

true to verify the authentication code of entries encrypted with AES. The verification detects encrypted data tampered or corrupted after the encryption.

true to verify the CRC-32 checksum of the entry against the value stored in the zip file. The verification is run on the decompressed data and covers the whole read pipeline. It also applies to entries encrypted with AES in AE-1 format. It is skipped for entries in AE-2 format because they store a zeroed CRC-32 value.

true to reject the entry with an ERR_AMBIGUOUS_ARCHIVE error when its local file header disagrees with its central directory record while calling FileEntry#getData, false to deposit the differences on EntryMetaData#warnings instead. This is the entry-level half of ZipReaderOptions#checkAmbiguity, exposed on its own so it can be enabled without the archive-level checks and disabled without giving up the rest of ZipReaderOptions#strictness. It is the only way to validate the local file headers of a self-extracting archive, since GetEntriesOptions#checkAmbiguity rejects prepended data outright.

true compares the filename as well, like ZipReaderOptions#strictness set to "strict"; false compares everything except the filename, like "tolerant". Set ZipReaderOptions#checkLocalFilename to control the filename comparison on its own. An explicit value takes precedence over the strictness default at every level.

true to compare the filename of the local file header with the one of the central directory record when calling FileEntry#getData, false to leave the filename out of that comparison.

Comparing the filename costs one extra read per entry whenever the local file header carries no extra field, which is why it is left out below ZipReaderOptions#strictness set to "strict". This option selects what is compared without changing whether a difference throws or warns, which ZipReaderOptions#checkLocalDirectory decides. It is therefore the only way to obtain WARNING_MISMATCHED_LOCAL_FILE_HEADER_FILENAME as a warning, with { checkLocalFilename: true, checkLocalDirectory: false }, and the only way to keep every other check of "strict" without paying the extra read, with { checkLocalFilename: false, strictness: "strict" }.

true to throw an ERR_OVERLAPPING_ENTRY error when calling FileEntry#getData if the entry overlaps with another entry on which FileEntry#getData has already been called (with the option checkOverlappingEntry or checkOverlappingEntryOnly set to true).

true to throw an ERR_OVERLAPPING_ENTRY error when calling FileEntry#getData if the entry overlaps with another entry on which FileEntry#getData has already been called (with the option checkOverlappingEntry or checkOverlappingEntryOnly set to true) without trying to read the content of the entry.

true to check only if the password is valid.

true to check the CRC-32 checksum of the entry.

true to read the data as-is without decompressing it and without decrypting it, "compressed" to decrypt it without decompressing it.

The password used to decrypt the content of the entry.

true to prevent closing of WritableWriter#writable when calling FileEntry#getData.

The password used to encrypt the content of the entry (raw).

The AbortSignal instance used to cancel the decompression.

A signal already aborted when the operation starts rejects it with ERR_ABORTED as the reason of the AbortError, or with signal.reason when it is set, without relying on the signal option of pipeTo that the oldest supported engines ignore.

How tolerant the reader should be when the local file header of an entry disagrees with its central directory record.

• "strict": compare the filename, the general purpose bit flag, the compression method, the CRC-32 checksum and the sizes, and throw an ERR_AMBIGUOUS_ARCHIVE error on any difference.
• "balanced": compare everything except the filename, and throw on any difference.
• "tolerant": compare everything except the filename, and deposit the differences on EntryMetaData#warnings instead of throwing.

Every field except the filename is read from the local file header anyway, to locate the entry data, so the comparison "balanced" performs reads no additional bytes. Comparing the filename reads the filename bytes as well, which costs one extra read per entry whenever the local file header carries no extra field — the common case in practice, and the reason the filename is left out below "strict". Use ZipReaderOptions#checkLocalDirectory to request or suppress the whole comparison explicitly, and ZipReaderOptions#checkLocalFilename to include or exclude the filename on its own.