You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
|
/*! * fragment-cache <https://github.com/jonschlinkert/fragment-cache>
* * Copyright (c) 2016-2017, Jon Schlinkert. * Released under the MIT License. */
'use strict';
var MapCache = require('map-cache');
/** * Create a new `FragmentCache` with an optional object to use for `caches`. * * ```js
* var fragment = new FragmentCache(); * ```
* @name FragmentCache * @param {String} `cacheName` * @return {Object} Returns the [map-cache][] instance. * @api public */
function FragmentCache(caches) { this.caches = caches || {}; }
/** * Prototype */
FragmentCache.prototype = {
/** * Get cache `name` from the `fragment.caches` object. Creates a new * `MapCache` if it doesn't already exist. * * ```js
* var cache = fragment.cache('files'); * console.log(fragment.caches.hasOwnProperty('files')); * //=> true
* ```
* @name .cache * @param {String} `cacheName` * @return {Object} Returns the [map-cache][] instance. * @api public */
cache: function(cacheName) { return this.caches[cacheName] || (this.caches[cacheName] = new MapCache()); },
/** * Set a value for property `key` on cache `name` * * ```js
* fragment.set('files', 'somefile.js', new File({path: 'somefile.js'})); * ```
* @name .set * @param {String} `name` * @param {String} `key` Property name to set * @param {any} `val` The value of `key` * @return {Object} The cache instance for chaining * @api public */
set: function(cacheName, key, val) { var cache = this.cache(cacheName); cache.set(key, val); return cache; },
/** * Returns true if a non-undefined value is set for `key` on fragment cache `name`. * * ```js
* var cache = fragment.cache('files'); * cache.set('somefile.js'); * * console.log(cache.has('somefile.js')); * //=> true
* * console.log(cache.has('some-other-file.js')); * //=> false
* ```
* @name .has * @param {String} `name` Cache name * @param {String} `key` Optionally specify a property to check for on cache `name` * @return {Boolean} * @api public */
has: function(cacheName, key) { return typeof this.get(cacheName, key) !== 'undefined'; },
/** * Get `name`, or if specified, the value of `key`. Invokes the [cache]() method, * so that cache `name` will be created it doesn't already exist. If `key` is not passed, * the entire cache (`name`) is returned. * * ```js
* var Vinyl = require('vinyl'); * var cache = fragment.cache('files'); * cache.set('somefile.js', new Vinyl({path: 'somefile.js'})); * console.log(cache.get('somefile.js')); * //=> <File "somefile.js">
* ```
* @name .get * @param {String} `name` * @return {Object} Returns cache `name`, or the value of `key` if specified * @api public */
get: function(name, key) { var cache = this.cache(name); if (typeof key === 'string') { return cache.get(key); } return cache; } };
/** * Expose `FragmentCache` */
exports = module.exports = FragmentCache;
|