Class ArchiveEntry

The file content for this entry. This may be null for entries loaded asynchronously, or for non-file entries like directories.

The header metadata parsed out for this entry. If you are attempting to read the content of this entry, do not modify this instance.

The context (if any) from which this entry was parsed. The context will include global data about things such as the origin of the archive and global pax headers.

The size in bytes of the header in the source buffer that this entry was parsed from. Returns zero by default if this was not parsed by a source buffer.

The starting absolute index (inclusive) in the source buffer that this entry was parsed from. Returns zero by default if this was not parsed by a source buffer.

Builds on top of readNextContentChunk() and creates an async iterator to consume these data chunks from.

Only necessary if this entry was extracted from an async buffer, since the entry does not hold the content of async buffers by default.

If the entry was extracted synchronously, its content will be available via the "content" property.

Do not use this on entries that have not been parsed from a source buffer, otherwise it will very likely return garbage data.

Prefer to use readNextContentChunk over this when possible, as using this during archive read iteration can cause double-loading of the same data and reduce performance.

Reads the next chunk of data for the content of this entry from the assigned source context.

This is only applicable in async contexts, where the entry content is not already available via the content property.

Convenience for decoding the current content buffer as a string. Note that if the content was not loaded for whatever reason, this will return an empty string.

Overridden to prevent circular reference errors / huge memory spikes that would include the underlying content by default.