Tarantool CE/EE Documentation portal logo
Помощь
Обновлена 15 сентября 2026 г. в 08:55

Node.js

Наиболее часто используемый драйвер Node.js – Node Tarantool driver. Он не входит в состав репозитория Tarantool и должен устанавливаться отдельно. Наиболее распространённый способ установки – с помощью npm. Например, на Ubuntu после установки npm процесс установки может выглядеть так:

$ npm install tarantool-driver --global

Ниже приведена полная программа на Node.js, которая вставляет кортеж [99999,'BB'] в спейс [999] через API Node.js. Перед запуском убедитесь, что экземпляр сервера принимает подключения на адресе localhost:3301 и что спейс examples существует, как описано в разделе Настройка сервера для примеров с коннекторами. Для запуска скопируйте код в файл с именем example.js и выполните команду node example.js.

Программа выполнит следующие действия:

  • Подключение с использованием определения спейса, заданного в приложении.
  • Открытие сокетного соединения с сервером Tarantool на адресе localhost:3301.
  • Отправку запроса INSERT и, при успешном выполнении, завершит работу, выведя сообщение Insert succeeded.

При этом:

  • Если Tarantool не запущен на адресе localhost:3301, программа выведет сообщение Connect failed.
  • Если у пользователя guest нет прав на подключение, программа выведет сообщение Auth failed.
  • Если запрос на вставку завершится ошибкой по любой причине, например, потому что кортеж уже существует, программа выведет сообщение Insert failed.
var TarantoolConnection = require('tarantool-driver');var conn = new TarantoolConnection({port: 3301});var insertTuple = [99999, "BB"];conn.connect().then(function() {    conn.auth("guest", "").then(function() {        conn.insert(999, insertTuple).then(function() {            console.log("Insert succeeded");            process.exit(0);    }, function(e) { console.log("Insert failed");  process.exit(1); });    }, function(e) { console.log("Auth failed");    process.exit(1); });    }, function(e) { console.log("Connect failed"); process.exit(1); });

В примере показан только один запрос и не продемонстрированы все аспекты, необходимые для полноценной работы. Подробнее см. в репозитории драйвера Node.js.