get

Get the value of a key

Description

Get the value of key. If the key does not exist, null is returned. An error is returned if the value stored at key is not a string.

Syntax

redis.get<TData>(key: string): Promise<TData | null>

Parameters

key · string · required

The key to retrieve

Type Parameters

TData · type · default: "string"

The expected type of the returned data. The SDK will attempt to deserialize the value to this type.

Returns

value · TData | null

The value of the key, or null if the key does not exist

Examples

Basic Usage

import { Redis } from '@upstash/redis';

const redis = new Redis({
  url: 'https://your-redis-url.upstash.io',
  token: 'your-token'
});

// Set and get a string value
await redis.set('mykey', 'Hello, World!');
const value = await redis.get('mykey');
console.log(value); // "Hello, World!"

// Get a non-existent key
const missing = await redis.get('nonexistent');
console.log(missing); // null

Working with JSON Data

interface User {
  id: number;
  name: string;
  email: string;
}

// Store JSON data
const user = { id: 1, name: 'Alice', email: '[e-mail]' };
await redis.set('user:1', JSON.stringify(user));

// Retrieve and parse JSON data
const userData = await redis.get<string>('user:1');
if (userData) {
  const parsedUser: User = JSON.parse(userData);
  console.log(parsedUser.name); // "Alice"
}

Using Automatic Deserialization

// The SDK can automatically deserialize values
interface Product {
  id: string;
  name: string;
  price: number;
}

const product = { id: 'p1', name: 'Widget', price: 19.99 };
await redis.set('product:1', product);

// Retrieve with type parameter
const retrieved = await redis.get<Product>('product:1');
console.log(retrieved?.price); // 19.99

Related Commands

• set - Set the string value of a key
• mget - Get the values of multiple keys

Redis Documentation

For more information, see the Redis GET documentation.