@speedy/require-cache

Speed up Node load time by caching resolved module paths to avoid module resolution and refetching each time the application is loaded.

The first time the application loads, resolved file paths are saved in the file system.

This modules patches the _resolveFilename method of Node module, caching the files it finds in order to improve Node loading performance.

This is inspired by fast-boot.

Benchmark results

Library	Uncached	Cached	Efficient	Duration
tslint	128.268 ms	82.189 ms	35.923 %	-46.078 ms
fs-extra	0.229 ms	0.236 ms	-2.991 %	0.007 ms
shelljs	59.767 ms	32.028 ms	46.412 %	-27.739 ms
stylelint	1492.165 ms	687.323 ms	53.938 %	-804.842 ms
postcss	71.924 ms	45.183 ms	37.179 %	-26.74 ms
yargs	97.382 ms	27.751 ms	71.503 %	-69.632 ms
eslint	359.556 ms	292.274 ms	18.712 %	-67.282 ms

Benchmark mark done on a Windows 7 64 Bit, i7-5500U CPU @ 2.40Ghz and 16GB RAM.

Getting Started

Installation

npm install @speedy/require-cache --save

Usage

import { RequireCache } from "@speedy/require-cache";
new RequireCache().start();

import * as stylelint from "stylelint";
import * as _ from "lodash";

Interfaces

CacheOptions

Name	Description	Type
cacheKiller	Used to invalidate the cache. By default it's set the version of package.json. Normally one will pass the application version number assuming that a different version or a Unix timestamp when the cache should expire. string: 'package.json' version: 1.0.0 number: Unix timestamp: 1490873027	number
cacheFilePath	Alternate cache file location. Default: ./.cache/speedy-require-cache.json	string
readOnlyMode	When in ReadOnly mode. Any changes will be discharged once process is terminated. Default: false	boolean

CacheStats

Name	Description	Type
cacheHit	Number of modules who's locations were found in the cache	number
cacheMiss	Number of modules who's locations were not found in the cache and were added to the cache	number
notCached	Number of modules not to be cached - either not in node_modules folder or process.cwd()	number

Methods and Properties

new RequireCache([options]: Partial<CacheOptions>) ⇒ RequireCache

Creates an instance of RequireCache.

requireCache.isEnabled : boolean

Whether or not the cache is currently enabled.

Read only: true

requireCache.stats : CacheStats

Caching effectiveness statistics.

Read only: true

Start caching of module locations.

requireCache.stop()

Stop caching of the modules locations.

requireCache.reset()

Deletes the cache file.

requireCache.save()

Saves cached paths to file.

Benchmark Yourself

If you'd like to run the benchmark yourself. Clone the Git repository and install all the dependencies executing the following commands in your terminal:

npm install
npm run benchmark-install

To benchmark run:

npm run benchmark