Files
lancedb/nodejs
Xuanwo 0d55457d9e test(node): make blob read cancellation deterministic (#5029)
The Node blob cancellation test assumes a 32 MiB local read is still in
flight when JavaScript immediately aborts. The native future can finish
first, in which case returning its completed buffer is valid.

Replace that timing assumption with the existing HTTP fixture: send one
byte of a five-byte range response, hold back the remaining body, then
abort. Verify `AbortError`, response disconnection, listener cleanup,
and a subsequent read on the same handle with the single request permit.
Existing local pre-abort, successful-read, cursor, and close coverage
remains in place; production cancellation semantics are unchanged.

Validated the 97 scoped Blob tests on Linux x64 / Node 22.23.4 with both
a locally built beta18 binding and the [beta19 native binding built for
#4967](https://github.com/lancedb/lancedb/actions/runs/43381450237/job/131739908253).
The beta19 run used the published repair tests at `8096f848`, passed all
97 cases with exit 0, and verified the downloaded artifact digest,
loaded binding hash, and native build checkout against #4967's source
tree. The pre-existing `CustomGC` import diagnostic remains; the process
exited normally.

The [hosted macOS ARM64
job](https://github.com/lancedb/lancedb/actions/runs/43395339041/job/131784902005)
also passed the cancellation regression and the complete applicable Jest
suite: 1,695 tests passed and 22 were skipped on Node 24.22.2 / beta18.
Its actual merge checkout `e906a2da` has matching test, native Blob,
dependency, and workflow sources to PR head `8096f848`.

A separate [macOS ARM64 / Node 22.23.4 / beta19 composition
run](https://github.com/lancedb/lancedb/actions/runs/43559120836/job/132353156252)
now passed 1,694 tests (23 skipped), including both in-flight
cancellation and later-response-body cancellation/permit release. It
tested the normal merge of #4967 `6b175764` and this repair `8096f848`,
at validation head `144e5294` whose only subsequent change narrows the
workflow and disables publication. The loaded native binding hash and
downloaded artifact digest were captured. The original failed #4967 job
is preserved; this separate validation does not replace normal
prerequisite integration or current-branch CI on #4967.
2026-11-14 20:57:49 +08:00
..
2025-01-29 08:27:07 -08:00

LanceDB JavaScript SDK

A JavaScript library for LanceDB.

Installation

npm install @lancedb/lancedb

This will download the appropriate native library for your platform. We currently support:

  • Linux (x86_64 and aarch64 on glibc and musl)
  • MacOS (Intel and ARM/M1/M2)
  • Windows (x86_64 and aarch64)

Usage

Basic Example

import * as lancedb from "@lancedb/lancedb";
const db = await lancedb.connect("data/sample-lancedb");
const table = await db.createTable("my_table", [
  { id: 1, vector: [0.1, 1.0], item: "foo", price: 10.0 },
  { id: 2, vector: [3.9, 0.5], item: "bar", price: 20.0 },
]);
const results = await table.vectorSearch([0.1, 0.3]).limit(20).toArray();
console.log(results);

The quickstart contains more complete examples.

Development

See CONTRIBUTING.md for information on how to contribute to LanceDB.