On this page

Options object for persistent file-based caching.

Type:boolean

Allows to collect unused memory allocated during deserialization. This requires copying data into smaller buffers and has a performance cost.

Type:{ [index: string]: string[] }

Dependencies the build depends on (in multiple categories, default categories: 'defaultWebpack').

Type:string

Base directory for the cache (defaults to node_modules/.cache/webpack).

Type:string

Locations for the cache (defaults to cacheDirectory / name).

Type:false | "gzip" | "brotli" | "zstd"

Compression type used for the cache files.

Type:string

Algorithm used for generation the hash (see node.js crypto package).

Type:number

Time in ms after which idle period the cache storing should happen.

Type:number

Time in ms after which idle period the cache storing should happen when larger changes has been detected (cumulative build time > 2 x avg cache store time).

Type:number

Time in ms after which idle period the initial cache storing should happen.

Type:(string | RegExp)[]

List of paths that are managed by a package manager and contain a version or hash in its path so all files are immutable.

Type:(string | RegExp)[]

List of paths that are managed by a package manager and can be trusted to not be modified otherwise.

Type:number

Time for which unused cache entries stay in the filesystem cache at minimum (in milliseconds).

Type:number

Number of generations unused cache entries stay in memory cache at minimum (0 = no memory cache used, 1 = may be removed after unused for a single compilation, ..., Infinity: kept forever). Cache entries will be deserialized from disk when removed from memory cache.

Type:boolean

Additionally cache computation of modules that are unchanged and reference only unchanged modules in memory.

Type:string

Name for the cache. Different names will lead to different coexisting caches.

Type:boolean

Track and log detailed timing information for individual cache items.

Type:boolean

Enable/disable readonly mode.

Type:"pack"

When to store data to the filesystem. (pack: Store data when compiler is idle in a single file).

Type:"filesystem"

Filesystem caching.

Type:string

Version of the cache data. Different versions won't allow to reuse the cache and override existing content. Update the version when config changed in a way which doesn't allow to reuse cache. This will invalidate the cache.