В этом материале мы поговорим о важнейших концепциях разработки нативных расширений для Node.js. В частности, здесь будет рассмотрен практический пример создания такого расширения, который вполне может стать вашим первым проектом в этой области.
![](https://habrastorage.org/r/w780q1/webt/r3/29/n6/r329n6bynqcrxgx7lrqja5kxcau.jpeg)
Если в двух словах рассказать о нативных расширениях для Node.js, можно отметить, что они представляют собой некую логику, реализованную на C++, которую можно вызывать из JavaScript-кода. Здесь стоит прояснить особенности работы Node.js и рассмотреть составные части этой платформы. Важно знать, что, в контексте Node.js, мы можем говорить о двух языках — JavaScript и C++. Всё это можно описать так:
Где же в этой схеме находятся нативные расширения? Рассмотрим это на примере операций для работы с диском. Доступ к дисковой подсистеме не входит в возможности JavaScript или V8. Libuv даёт возможности асинхронного выполнения кода. Однако, пользуясь Node.js, можно писать данные на диск и читать их. Именно здесь на помощь приходят нативные расширения. Модуль
![](https://habrastorage.org/r/w780q1/getpro/habr/post_images/b6c/351/8c2/b6c3518c2ddb8c89bc67ea9bbea75ece.jpg)
Взаимодействие с нативными расширениями из JS-кода
Понимая этот механизм, мы можем сделать первые шаги в разработке нативных расширений. Но, прежде чем заняться программированием, поговорим об инструментах.
Этот файл позволяет настраивать параметры компиляции нативных расширений. Один из важнейших моментов, которые нам надо определить, заключается в том, какие файлы будут компилироваться, и в том, как мы будем вызывать готовую библиотеку. Структура этого файла напоминает JSON, он содержит настройки цели (target) и исходников (sources) для компиляции.
Средство node-gyp предназначено для компиляции нативных расширений. Оно реализовано на базе Node.js и доступно в npm, что позволяет скомпилировать расширение соответствующей командой. В ответ на эту команду система обнаружит файл
Кроме того,
Пакет node-bindings позволяет экспортировать нативные расширения. Он отвечает за поиск соответствующих файлов в папке
N-api — это API, созданное средствами C, которое позволяет взаимодействовать с движком абстрактным способом, не зависящим от нижележащей среды исполнения. На наш взгляд, такой подход является результатом развития платформы, в ходе которого предпринимались усилия по портированию Node.js на различные архитектуры.
N-api даёт стабильность и совместимость при работе с различными версиями Node.js. Таким образом, если некое нативное расширение было скомпилировано для Node 8.1, не потребуется компилировать его снова для Node 8.6 или 9.3. Это упрощает жизнь тем, кто занимается поддержкой расширения или участвует в его разработке.
В данный момент n-api находится в экспериментальном состоянии.
Модуль node-addon-api даёт в распоряжение разработчика C++-реализацию n-api, которая позволят пользоваться возможностями этого языка.
Обратите внимание на то, что для этого примера использована платформа Node 9.3.
Для того, чтобы приступить к разработке нативных расширений, мы напишем классическое приложение «Hello World». Идея этого приложения позволяет реализовать его с помощью достаточно простого кода, не перегруженного дополнительной логикой, что даст нам возможность сосредоточиться на основных конструкциях, рассмотреть минимально необходимый код.
Начнём с инициализации npm, что позволит затем установить зависимости.
Теперь устанавливаем зависимости.
На данном этапе нужно создать файл на C++, содержащий логику расширения.
В этом файле имеется три важных части, которые мы рассмотрим, начиная с той, которая находится в нижней части текста.
Теперь создадим файл
А вот как выглядит JavaScript-код, в котором подключается расширение и осуществляется работа с ним.
Теперь осталось лишь скомпилировать расширение и запустить JS-файл. Вот как это выглядит.
![](https://habrastorage.org/getpro/habr/post_images/be3/a16/64f/be3a1664fd99e7c7be9d621c4c248851.gif)
Компиляция и использование нативного расширения
Полагаем, полезно рассказать об истории нативных расширений, так как изучение этого вопроса позволяет исследовать большой объём полезной документации и обнаружить множество примеров. N-api пришло на смену nan. Эта аббревиатура расшифровывается как Native Abstraction for Node.js. Nan — это C++-библиотека, которая не отличается той же гибкостью, что и n-api. Она позволяет, в абстрактном виде, работать с V8, но привязана к релизу V8. В результате, в новых релизах Node.js могут присутствовать изменения V8, которые способны нарушить работу нативных расширений. Решение этой проблемы — одна из причин появления n-api.
Знание о существовании nan позволяет нам исследовать соответствующие примеры и документацию. Всё это может стать полезным источником знаний для тех, кто изучает разработку нативных расширений для Node.js.
Вот список полезных материалов, посвящённых разработке нативных расширений для Node:
Автор этого материала говорит, что изучение разработки нативных расширений для Node.js помогло ему лучше понять устройство этой платформы и особенности её функционирования. Существует множество сценариев, в которых подобные расширения могут оказаться полезными. Среди них — создание высокопроизводительных приложений, интеграция Node.js-проектов с C/C++ библиотеками, или использование в таких проектах устаревшего кода. Кроме того, разработка нативных расширений — это отличный способ изучения внутренних механизмов Node.js.
Уважаемые читатели! Пользуетесь ли вы нативными расширениями для Node.js в своих проектах?
![](https://habrastorage.org/r/w1560/files/1ba/550/d25/1ba550d25e8846ce8805de564da6aa63.png)
![](https://habrastorage.org/webt/r3/29/n6/r329n6bynqcrxgx7lrqja5kxcau.jpeg)
Основы разработки нативных расширений для Node.js
Если в двух словах рассказать о нативных расширениях для Node.js, можно отметить, что они представляют собой некую логику, реализованную на C++, которую можно вызывать из JavaScript-кода. Здесь стоит прояснить особенности работы Node.js и рассмотреть составные части этой платформы. Важно знать, что, в контексте Node.js, мы можем говорить о двух языках — JavaScript и C++. Всё это можно описать так:
- JavaScript — это язык программирования, на котором пишут проекты под Node.js.
- V8 — это движок, занятый выполнением JS-кода.
- Libuv — это библиотека, написанная на C, реализующая асинхронное выполнение кода.
Где же в этой схеме находятся нативные расширения? Рассмотрим это на примере операций для работы с диском. Доступ к дисковой подсистеме не входит в возможности JavaScript или V8. Libuv даёт возможности асинхронного выполнения кода. Однако, пользуясь Node.js, можно писать данные на диск и читать их. Именно здесь на помощь приходят нативные расширения. Модуль
fs
реализован средствами C++ (у него имеется доступ к диску), он даёт нам методы, вроде writeFile
и readFile
, которые можно вызывать из JavaScript.![](https://habrastorage.org/getpro/habr/post_images/b6c/351/8c2/b6c3518c2ddb8c89bc67ea9bbea75ece.jpg)
Взаимодействие с нативными расширениями из JS-кода
Понимая этот механизм, мы можем сделать первые шаги в разработке нативных расширений. Но, прежде чем заняться программированием, поговорим об инструментах.
Базовые инструменты
▍Файл binding.gyp
Этот файл позволяет настраивать параметры компиляции нативных расширений. Один из важнейших моментов, которые нам надо определить, заключается в том, какие файлы будут компилироваться, и в том, как мы будем вызывать готовую библиотеку. Структура этого файла напоминает JSON, он содержит настройки цели (target) и исходников (sources) для компиляции.
▍Инструмент node-gyp
Средство node-gyp предназначено для компиляции нативных расширений. Оно реализовано на базе Node.js и доступно в npm, что позволяет скомпилировать расширение соответствующей командой. В ответ на эту команду система обнаружит файл
binging.gyp
, находящийся в корневой директории, и приступит к компиляции расширения.Кроме того,
node-gyp
позволяет, по умолчанию, формировать релизные сборки или сборки для отладки. В результате, в зависимости от настроек, после компиляции, в папке release
или debug
, будет создан бинарный файл с расширением .node
.▍Инструмент node-bindings
Пакет node-bindings позволяет экспортировать нативные расширения. Он отвечает за поиск соответствующих файлов в папке
build
или release
.▍API n-api
N-api — это API, созданное средствами C, которое позволяет взаимодействовать с движком абстрактным способом, не зависящим от нижележащей среды исполнения. На наш взгляд, такой подход является результатом развития платформы, в ходе которого предпринимались усилия по портированию Node.js на различные архитектуры.
N-api даёт стабильность и совместимость при работе с различными версиями Node.js. Таким образом, если некое нативное расширение было скомпилировано для Node 8.1, не потребуется компилировать его снова для Node 8.6 или 9.3. Это упрощает жизнь тем, кто занимается поддержкой расширения или участвует в его разработке.
В данный момент n-api находится в экспериментальном состоянии.
▍Инструмент node-addon-api
Модуль node-addon-api даёт в распоряжение разработчика C++-реализацию n-api, которая позволят пользоваться возможностями этого языка.
Первые шаги в мире нативных расширений
Обратите внимание на то, что для этого примера использована платформа Node 9.3.
Для того, чтобы приступить к разработке нативных расширений, мы напишем классическое приложение «Hello World». Идея этого приложения позволяет реализовать его с помощью достаточно простого кода, не перегруженного дополнительной логикой, что даст нам возможность сосредоточиться на основных конструкциях, рассмотреть минимально необходимый код.
Начнём с инициализации npm, что позволит затем установить зависимости.
npm init
Теперь устанавливаем зависимости.
npm i node-addon-api bindings
На данном этапе нужно создать файл на C++, содержащий логику расширения.
#include <napi.h>
Napi::String SayHi(const Napi::CallbackInfo& info) {
Napi::Env env = info.Env();
return Napi::String::New(env, "Hi!");
}
Napi::Object init(Napi::Env env, Napi::Object exports) {
exports.Set(Napi::String::New(env, "sayHi"), Napi::Function::New(env, SayHi));
return exports;
};
NODE_API_MODULE(hello_world, init);
В этом файле имеется три важных части, которые мы рассмотрим, начиная с той, которая находится в нижней части текста.
NODE_API_MODULE
. Первый аргумент представляет собой имя нативного расширения, второй — имя функции, которая инициализирует это расширение.init
. Это — функция, которая ответственна за инициализацию расширения. Тут мы должны экспортировать функции, которые будут вызываться из JS-кода. Для того чтобы это сделать, нужно записать имя функции в объектexports
и задать саму функцию, которая будет вызываться. Функцияinit
должна возвращать объектexports
.sayHi
. Эта функция будет выполнена при вызове нашего нативного расширения из JavaScript.
Теперь создадим файл
binding.gyp
, который будет содержать конфигурацию нативного расширения.{
"targets": [
{
"cflags!": [ "-fno-exceptions" ],
"cflags_cc!": [ "-fno-exceptions" ],
"include_dirs" : [
"<!@(node -p \"require('node-addon-api').include\")"
],
"target_name": "hello_world",
"sources": [ "hello_world.cc" ],
'defines': [ 'NAPI_DISABLE_CPP_EXCEPTIONS' ]
}
]
}
А вот как выглядит JavaScript-код, в котором подключается расширение и осуществляется работа с ним.
const hello_world = require('bindings')('hello_world')
console.log(hello_world.sayHi());
Теперь осталось лишь скомпилировать расширение и запустить JS-файл. Вот как это выглядит.
![](https://habrastorage.org/getpro/habr/post_images/be3/a16/64f/be3a1664fd99e7c7be9d621c4c248851.gif)
Компиляция и использование нативного расширения
История нативных расширений для Node.js и полезные материалы
Полагаем, полезно рассказать об истории нативных расширений, так как изучение этого вопроса позволяет исследовать большой объём полезной документации и обнаружить множество примеров. N-api пришло на смену nan. Эта аббревиатура расшифровывается как Native Abstraction for Node.js. Nan — это C++-библиотека, которая не отличается той же гибкостью, что и n-api. Она позволяет, в абстрактном виде, работать с V8, но привязана к релизу V8. В результате, в новых релизах Node.js могут присутствовать изменения V8, которые способны нарушить работу нативных расширений. Решение этой проблемы — одна из причин появления n-api.
Знание о существовании nan позволяет нам исследовать соответствующие примеры и документацию. Всё это может стать полезным источником знаний для тех, кто изучает разработку нативных расширений для Node.js.
Вот список полезных материалов, посвящённых разработке нативных расширений для Node:
- Примеры использования n-api.
- Примеры работы с node-addon-api.
- Примеры использования nan.
- Тесты, ценный источник знаний.
- Ресурс, посвящённый нативным расширениям для Node.js.
Итоги
Автор этого материала говорит, что изучение разработки нативных расширений для Node.js помогло ему лучше понять устройство этой платформы и особенности её функционирования. Существует множество сценариев, в которых подобные расширения могут оказаться полезными. Среди них — создание высокопроизводительных приложений, интеграция Node.js-проектов с C/C++ библиотеками, или использование в таких проектах устаревшего кода. Кроме того, разработка нативных расширений — это отличный способ изучения внутренних механизмов Node.js.
Уважаемые читатели! Пользуетесь ли вы нативными расширениями для Node.js в своих проектах?
![](https://habrastorage.org/files/1ba/550/d25/1ba550d25e8846ce8805de564da6aa63.png)