npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

vscode-cache

v0.3.0

Published

Persistent setting and value caching for Visual Studio Code extension authors

Downloads

115

Readme

Visual Studio Code extension value caching

This module is intended to be used only by Visual Studio Code extension authors. While it does not have any other module dependencies, it is only useful for developing VSCode extensions and serves no other real purpose outside the scope of Visual Studio Code extension development.


vscode-cache is an abstraction of the VSCode API ExtensionContext.globalState interface. The globalState object is a simple storage mechanism that extensions can use to save and retrieve values and objects persistently (even between VSCode sessions). vscode-cache is a simple and powerful interface that wraps the globalState object, adding expirations, existence checking, etc.

Why would I want to use this in my VSCode extension?

This module is ideal for extensions to store arbitrary data for long or short term. Some examples:

  • Cache data that you grabbed from some database instead of hitting that database server each time
  • Cache results from that 3rd party REST API that charges you for each connection
  • Save user input that you aquired via the vscode.window.showInputBox() or vscode.window.showQuickPick() methods

Installation

# npm install vscode-cache --save

Basic Usage

// First, get the module into your extension code
const Cache = require('vscode-cache');

// Extension activation method
let activate = (extensionContext) => {

  // Instantiate the cache by passing your `ExtensionContext` object into it
  let myCache = new Cache(extensionContext);

  // Save an item to the cache by specifying a key and value
  myCache.put('userName', 'John Doe')
    .then(() => {

      // Does the cache have userName?
      console.log(myCache.has('userName')); // returns true

      // Fetch the userName from the cache
      let userName = myCache.get('userName');

    });
};

Optional expirations

You can optionally pass an expiration/lifetime (in seconds) for the cached item. If the current time is passed the expiration, then the cache no longer has it.

// Save something in the cache for 5 seconds
myCache.put('searchResults', results, 5)
  .then(()=> {

    // Does the cache still have it?
    console.log(myCache.has('searchResults')); // returns true

    // Does the cache still have it 10 seconds later?
    setTimeout(() => {

      console.log(myCache.has('searchResults')); // returns false

    }, 10000);
  });

Default values

You can optionally specify a default value when fetching a cache item just in case it doesn't exist or is expired.

// Does the cache contain this value?
myCache.has('foo'); // returns false

// Fetch the value of foo, but give it a default value of "bar"
let foo = myCache.get('foo', 'bar');

console.log(foo); // returns bar

Custom Namespaces

You can specify an optional namespace when instantiating your cache just in case you wanted more than one cache. This keeps them separate within the globalState object. The advantage of this is that you can use the same cache keys on different caches in order to store different values.

// Create a cache for some API
let apiCache = new Cache(extensionContext, 'api');

// Create some sort of database cache
let databaseCache = new Cache(extensionContext, 'database');

// Store a value into the api cache using the key 'foo'
apiCache.put('foo', apiResults);

// Store a different value into the database cache using the key 'foo'
databaseCache.put('foo', databaseResults);

// Because there are two caches, you can use the same keys in each without overriding values

Cache

Kind: global class


new Cache(context, [namespace])

A module for use in developing a Visual Studio Code extension. It allows an extension to cache values across sessions with optional expiration times using the ExtensionContext.globalState.

Returns: Cache - The cache object


cache.put(key, value, [expiration]) ⇒ Thenable

Store an item in the cache, with optional expiration

Kind: instance method of Cache
Returns: Thenable - Visual Studio Code Thenable (Promise)


cache.get(key, [defaultValue]) ⇒ any

Get an item from the cache, or the optional default value

Kind: instance method of Cache
Returns: any - Returns the cached value or optional defaultValue


cache.has(key) ⇒ boolean

Checks to see if unexpired item exists in the cache

Kind: instance method of Cache


cache.forget(key) ⇒ Thenable | false

Removes an item from the cache

Kind: instance method of Cache
Returns: Thenable | false - Visual Studio Code Thenable (Promise) or false if key does not exist


cache.keys() ⇒ Array.<string>

Get an array of all cached item keys

Kind: instance method of Cache


cache.all() ⇒ object

Returns object of all cached items

Kind: instance method of Cache


cache.flush() ⇒ Thenable

Clears all items from the cache

Kind: instance method of Cache
Returns: Thenable - Visual Studio Code Thenable (Promise)


cache.expiration(key) ⇒ number

Gets the expiration time for the cached item

Kind: instance method of Cache
Returns: number - Unix Timestamp in seconds


cache.isExpired(item) ⇒ boolean

Checks to see if cached item is expired

Kind: instance method of Cache