From 26105034da4fcce7ac883c899d781f016559310d Mon Sep 17 00:00:00 2001 From: ruki Date: Thu, 8 Nov 2018 00:38:48 +0800 Subject: switch to vuepress --- node_modules/cache-loader/README.md | 210 ++++++++++++++++++++++++++++++++++++ 1 file changed, 210 insertions(+) create mode 100644 node_modules/cache-loader/README.md (limited to 'node_modules/cache-loader/README.md') diff --git a/node_modules/cache-loader/README.md b/node_modules/cache-loader/README.md new file mode 100644 index 00000000..327496aa --- /dev/null +++ b/node_modules/cache-loader/README.md @@ -0,0 +1,210 @@ +[![npm][npm]][npm-url] +[![node][node]][node-url] +[![deps][deps]][deps-url] +[![test][test]][test-url] +[![coverage][cover]][cover-url] +[![chat][chat]][chat-url] + +
+ + + +

Cache Loader

+

Caches the result of following loaders on disk (default) or in the database

+
+ +

Install

+ +```bash +npm install --save-dev cache-loader +``` + +

Usage

+ +Add this loader in front of other (expensive) loaders to cache the result on disk. + +**webpack.config.js** +```js +module.exports = { + module: { + rules: [ + { + test: /\.ext$/, + use: [ + 'cache-loader', + ...loaders + ], + include: path.resolve('src') + } + ] + } +} +``` + +> ⚠️ Note that there is an overhead for saving the reading and saving the cache file, so only use this loader to cache expensive loaders. + +

Options

+ +|Name|Type|Default|Description| +|:--:|:--:|:-----:|:----------| +|**`cacheKey`**|`{Function(options, request) -> {String}}`|`undefined`|Allows you to override default cache key generator| +|**`cacheDirectory`**|`{String}`|`path.resolve('.cache-loader')`|Provide a cache directory where cache items should be stored (used for default read/write implementation)| +|**`cacheIdentifier`**|`{String}`|`cache-loader:{version} {process.env.NODE_ENV}`|Provide an invalidation identifier which is used to generate the hashes. You can use it for extra dependencies of loaders (used for default read/write implementation)| +|**`write`**|`{Function(cacheKey, data, callback) -> {void}}`|`undefined`|Allows you to override default write cache data to file (e.g. Redis, memcached)| +|**`read`**|`{Function(cacheKey, callback) -> {void}}`|`undefined`|Allows you to override default read cache data from file| + +

Examples

+ +**webpack.config.js** +```js +module.exports = { + module: { + rules: [ + { + test: /\.js$/, + use: [ + 'cache-loader', + 'babel-loader' + ], + include: path.resolve('src') + } + ] + } +} +``` + +### `Database Integration` + +**webpack.config.js** +```js +// Or different database client - memcached, mongodb, ... +const redis = require('redis'); +const crypto = require('crypto'); + +// ... +// connect to client +// ... + +const BUILD_CACHE_TIMEOUT = 24 * 3600; // 1 day + +function digest(str) { + return crypto.createHash('md5').update(str).digest('hex'); +} + +// Generate own cache key +function cacheKey(options, request) { + return `build:cache:${digest(request)}`; +} + + +// Read data from database and parse them +function read(key, callback) { + client.get(key, (err, result) => { + if (err) { + return callback(err); + } + + if (!result) { + return callback(new Error(`Key ${key} not found`)); + } + + try { + let data = JSON.parse(result); + callback(null, data); + } catch (e) { + callback(e); + } + }); +} + + +// Write data to database under cacheKey +function write(key, data, callback) { + client.set(key, JSON.stringify(data), 'EX', BUILD_CACHE_TIMEOUT, callback); +} + +module.exports = { + module: { + rules: [ + { + test: /\.js$/, + use: [ + { + loader: 'cache-loader', + options: { + cacheKey, + read, + write, + } + }, + 'babel-loader' + ], + include: path.resolve('src') + } + ] + } +} +``` + +

Maintainers

+ + + + + + + + + + + +
+ + +
+ Tobias Koppers + + 		+ + +
+ Juho Vepsäläinen + + 		+ + +
+ Joshua Wiens + + 		+ + +
+ Michael Ciniawsky + + 		+ + +
+ Alexander Krasnoyarov + +
+ + +[npm]: https://img.shields.io/npm/v/cache-loader.svg +[npm-url]: https://npmjs.com/package/cache-loader + +[node]: https://img.shields.io/node/v/cache-loader.svg +[node-url]: https://nodejs.org + +[deps]: https://david-dm.org/webpack-contrib/cache-loader.svg +[deps-url]: https://david-dm.org/webpack-contrib/cache-loader + +[chat]: https://img.shields.io/badge/gitter-webpack%2Fwebpack-brightgreen.svg +[chat-url]: https://gitter.im/webpack/webpack + +[test]: https://img.shields.io/travis/webpack-contrib/cache-loader.svg +[test-url]: https://travis-ci.org/webpack-contrib/cache-loader + +[cover]: https://codecov.io/gh/webpack-contrib/cache-loader/branch/master/graph/badge.svg +[cover-url]: https://codecov.io/gh/webpack-contrib/cache-loader -- cgit v1.2.3