Basic Cache Operations with the JavaScript Client

What You Will Learn

How to connect to an Infinispan Server and perform basic cache operations including put, get, remove, replace, bulk operations, and clearing the cache.

Prerequisites

Node.js 22+
An Infinispan Server running on localhost:11222

Start an Infinispan Server with Docker or Podman:

docker run -it --rm -p 11222:11222 -e USER=admin -e PASS=password quay.io/infinispan/server:latest

Tip	You can replace `docker` with `podman` in the command above if you use Podman.

Step 1: Install Dependencies

cd non-java-clients/javascript
npm install

Step 2: Connect to the Server

Connect to the Infinispan Server with SCRAM-SHA-256 authentication:

const client = await ispn.client({port: 11222, host: '127.0.0.1'}, {
    authentication: {
        enabled: true,
        saslMechanism: 'SCRAM-SHA-256',
        userName: 'admin',
        password: 'password'
    }
});

Step 3: Put and Get Entries

Store a value and retrieve it by key:

await client.put('name', 'Infinispan');
const name = await client.get('name');

Check whether a key exists with containsKey:

const exists = await client.containsKey('name');

Step 4: Bulk Operations

Use putAll and getAll for multiple entries at once:

await client.putAll([
    {key: 'key1', value: 'value1'},
    {key: 'key2', value: 'value2'},
    {key: 'key3', value: 'value3'}
]);
const result = await client.getAll(['key1', 'key2', 'key3']);

Step 5: Replace and Remove

Replace an existing value and remove an entry:

await client.replace('key1', 'newValue1');
await client.remove('key2');

Step 6: Run the Tutorial

npm run cache

You should see output like:

get(name) = Infinispan
containsKey(name) = true

Bulk operations:
  key1 = value1
  key2 = value2
  key3 = value3

replaced key1: true
get(key1) = newValue1

removed key2: true
get(key2) = undefined

Cache size: 3
Cache cleared. Size: 0

What’s Next

Cache event listeners for reacting to cache changes
Cache encodings for different media type formats