---
title: "JavaScript"
description: "Embedding SurrealDB in JavaScript"
canonical_url: "https://surrealdb.com/docs/integrate/embedding/by-language/javascript"
section: "By language"
surrealdb_version: "4.x"
last_modified: "2026-11-18T02:09:16Z"
---

> Full SurrealDB documentation index: https://surrealdb.com/docs/llms.txt

# JavaScript

Embedding SurrealDB in JavaScript

SurrealDB is designed to be run in many different ways and in many environments. Because the same [query engine](/docs/learn/data-models/architecture.md) runs on every storage engine, SurrealDB can be run in embedded mode, from within your JavaScript environments.

You can embed SurrealDB in both browser and server environments.

**SurrealDB 4.x**

In browser environments using the [Wasm engine](/docs/reference/javascript/engines/wasm.md), SurrealDB can be run as an in-memory database, or it can persist data with SurrealKV over the browser's Origin Private File System (OPFS). In server environments using the [Node.js engine](/docs/reference/javascript/engines/node.md), SurrealDB can be run as an embedded database, backed by an in-memory engine (`mem://`) or [SurrealKV](/docs/running/file-backed.md) (`surrealkv://`).

**SurrealDB 3.x**

In browser environments using the [Wasm engine](/docs/reference/javascript/engines/wasm.md), SurrealDB can be run as an in-memory database, or it can persist data using IndexedDB. In server environments using the [Node.js engine](/docs/reference/javascript/engines/node.md), SurrealDB can be run as an embedded database, backed by an in-memory engine (`mem://`), RocksDB (`rocksdb://`) or [SurrealKV](/docs/running/file-backed.md) (`surrealkv://`).

The sections below cover embedding SurrealDB in browser and in server environments.

## Browser

**SurrealDB 4.x**

In browser environments, using the [Wasm engine](/docs/reference/javascript/engines/wasm.md), you can run SurrealDB in-memory (`mem://`) or with SurrealKV persistence (`surrealkv://`). A persistent database has to run in a dedicated web worker.

**SurrealDB 3.x**

In browser environments, using the [Wasm engine](/docs/reference/javascript/engines/wasm.md), you can run SurrealDB in-memory or with IndexedDB persistence.

For more information on how to embed SurrealDB in browser environments, please see the [Wasm engine](/docs/reference/javascript/engines/wasm.md) documentation.

## Server

In server environments, you can use the [Node.js engine](/docs/reference/javascript/engines/node.md) to run SurrealDB as an embedded database.

For more information on how to embed SurrealDB in server environments, please see the [Node.js engine](/docs/reference/javascript/engines/node.md) documentation.
