Обновление до Node.js SDK Admin SDK v10 (модульный SDK)

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

В версии 10 Admin Node.js SDK внесены два важных изменения:

• Поддержка Node.js 10 прекращена (это критическое изменение )
• В SDK принята модульная модель API.

В этом руководстве содержатся инструкции и информация, которые помогут разработчикам обновить существующие приложения Node.js с более ранних версий Admin SDK до v10.

Обновите Node.js до версии 12 или выше.

С выпуском Admin Node.js SDK v10 Firebase прекратила поддержку Node.js 10. Разработчики должны использовать Node.js 12 или выше при использовании Admin SDK . Если вы используете Admin Node.js SDK вместе с Cloud Functions for Firebase , убедитесь, что вы обновили версию Node.js до 12 или выше.

Используйте модули вместо пространств имен

С момента своего создания Admin Node.js SDK предлагал стабильный API, структурированный как вложенная иерархия пространств имен. В результате вы могли быть знакомы с написанием кода, который выглядит следующим образом:

// Import the global admin namespace
import * as admin from 'firebase-admin';

const app: admin.app.App = admin.initializeApp();

const token: string = await admin.auth().createCustomToken('alice');

const user: admin.auth.UserRecord = await admin.auth().getUser('bob');

Начиная с версии 10, Admin Node.js SDK предлагает несколько точек входа модуля с именованными экспортами. Мы рекомендуем разработчикам использовать эти новые точки входа для доступа к различным API SDK, а не использовать глобальное пространство имен admin .

Вот как будет выглядеть приведенный выше пример с новыми точками входа модуля:

// Import only what you need
import { initializeApp, App } from 'firebase-admin/app';
import { getAuth, UserRecord } from 'firebase-admin/auth';

const app: App = initializeApp();

const token: string = await getAuth().createCustomToken('alice');

const user: UserRecord = getAuth().getUser('bob');

// Import only what you need
const { initializeApp } = require('firebase-admin/app');
const { getAuth } = require('firebase-admin/auth');

const app = initializeApp();

const token = await getAuth().createCustomToken('alice');

const user = getAuth().getUser('bob');

Использование модульных точек входа v10

Обратите внимание, что в приведенных выше примерах вы больше не импортируете глобальное пространство имен admin . Вместо этого вы явно импортируете только нужные вам символы из нескольких точек входа модуля. Кроме того, разработчикам TypeScript больше не нужно использовать трижды вложенные идентификаторы типов, такие как admin.auth.UserRecord и admin.database.Reference . Поскольку каждый тип принадлежит ровно одному модулю, вы можете просто импортировать их по их коротким именам, таким как UserRecord и Reference .

Вот все точки входа модуля, доступные в SDK по состоянию на версию 10:

• firebase-admin/приложение
• firebase-admin/auth
• firebase-admin/база данных
• firebase-admin/firestore
• firebase-admin/instance-id
• firebase-admin/машинное обучение
• firebase-admin/сообщения
• firebase-admin/управление-проектами
• firebase-admin/удаленная-конфигурация
• firebase-admin/правила безопасности
• firebase-администратор/хранение

В следующей таблице показан синтаксис импорта замены для каждой из устаревших функций пространства имен:

Используйте экспортированные функции вместо методов в приложении

В устаревшем API объект App предоставлял ряд методов, таких как app.auth() и app.database() . Мы рекомендуем разработчикам избегать использования этих методов и вместо этого использовать те же точки входа модуля, описанные выше, для получения экземпляров службы, привязанных к данному объекту App , и выполнять другие задачи, специфичные для приложения.

Поддержка модулей ES

Node.js 12 и выше поставляются с экспериментальной поддержкой модулей ES, что позволяет даже разработчикам, не использующим TypeScript, использовать ключевые слова export и import в своем коде. Начиная с версии v10, Admin Node.js SDK также обеспечивает поддержку модулей ES, так что разработчики, реализующие модули ES на простом Node.js, могут импортировать SDK с помощью синтаксиса import .

Чтобы использовать модули ES с Admin SDK , сначала убедитесь, что вы включили поддержку ESM для среды выполнения Node.js. Обычно это делается путем добавления поля "type": "module" в файл package.json . Затем вы можете написать код приложения, который выглядит следующим образом:

// With {type: module} in the package.json...

// Import only what you need
import { initializeApp }  from 'firebase-admin/app';
import { getAuth } from 'firebase-admin/auth';

const app = initializeApp();

const token = await getAuth().createCustomToken('alice');

const user = getAuth().getUser('bob');