Функции
Функция | Описание |
---|---|
экземпляр (экземпляр) | Регистрирует функцию, которая срабатывает по событиям из определенного экземпляра базы данных Firebase Realtime. |
ссылка (путь) | Регистрирует функцию, которая срабатывает при событиях записи в базу данных Firebase Realtime. |
Классы
Сорт | Описание |
---|---|
Снимок данных | Интерфейс, представляющий снимок данных базы данных Firebase Realtime. |
Построитель экземпляров | Интерфейс конструктора экземпляров базы данных Firebase Realtime. Доступ через [ database.instance() ](providers_database_.html#instance). |
РефБилдер | Интерфейс построителя ссылок на базу данных Firebase Realtime. Доступ через [ functions.database.ref() ](functions.database#.ref). |
база данных.экземпляр()
Регистрирует функцию, которая срабатывает по событиям из определенного экземпляра базы данных Firebase Realtime.
Используйте этот метод вместе с ref
, чтобы указать экземпляр, в котором следует отслеживать события базы данных. Например: firebase.database.instance('my-app-db-2').ref('/foo/bar')
Обратите внимание, что functions.database.ref
, используемый без instance
отслеживает события в экземпляре *default*.
Подпись:
export declare function instance(instance: string): InstanceBuilder;
Параметры
Параметр | Тип | Описание |
---|---|---|
пример | нить | Имя экземпляра базы данных, для отслеживания событий записи. |
Возврат:
Интерфейс конструктора экземпляров базы данных Firebase Realtime.
база данных.ref()
Регистрирует функцию, которая срабатывает при событиях записи в базу данных Firebase Realtime.
Этот метод ведет себя очень похоже на одноименный метод в клиентском и административном SDK Firebase. Любое изменение в базе данных, которое влияет на данные по указанному path
или ниже, вызовет событие в облачных функциях.
Существует три важных различия между прослушиванием событий базы данных реального времени в облачных функциях и использованием базы данных реального времени в клиентских и административных SDK:
Облачные функции допускают использование подстановочных знаков в имени
path
. Любой компонентpath
в фигурных скобках ({}
) — это подстановочный знак, который соответствует всем строкам. Значение, соответствующее определенному вызову облачной функции, возвращается как часть [EventContext.params
](cloud_functions_eventcontext.html#params object. Например,ref("messages/{messageId}")
соответствует изменениям в/messages/message1
или/messages/message2
, в результате чегоevent.params.messageId
будет присвоено значение"message1"
или"message2"
, соответственно.Облачные функции не запускают событие для данных, которые уже существовали до развертывания облачной функции.
События облачной функции имеют доступ к дополнительной информации, включая снимок данных предыдущего события и информацию о пользователе, который запустил облачную функцию.
Подпись:
export declare function ref<Ref extends string>(path: Ref): RefBuilder<Ref>;
Параметры
Параметр | Тип | Описание |
---|---|---|
путь | Ссылка | Путь в базе данных для отслеживания событий записи. |
Возврат:
РефБилдер <Ссылка>
Интерфейс конструктора баз данных Firebase Realtime.