| /*! |
| * 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; |