firebase-childrenkeys

Exports a method which fetches the children keys of a Firebase Admin Database Reference via the REST API.

API Reference

The default export is a method with the following signature:

(ref[, options]) => string[]

Arguments

ref is a Firebase Admin Database Reference.

options is an optional object containing the following configuration options:

• maxTries - The maximum number of times to try to fetch the keys, in case of transient errors (defaults to 1).
• retryInterval - The number of milliseconds to delay between retries (defaults to 1000).
• timeout - The maximum number of milliseconds allowed for the overall request, including all fetch attempts and retry delays (defaults to no timeout). Any fetch in progress is aborted when the timeout expires.
• agent - The HTTP(S) agent to use when requesting data (defaults to none).

Return Value

An array of strings representing the children keys of the provided Firebase Admin Database Reference. If the provided reference has no children, the return value will be an empty array.

Example Usage

const admin = require('firebase-admin');
const firebaseChildrenKeys = require('firebase-childrenkeys');

admin.initializeApp(
  // ...
);

const db = admin.database();
const fooRef = db.ref('foo');

// Fetch all children keys of fooRef.
firebaseChildrenKeys(fooRef)
  .then((keys) => {
    if (keys.length === 0) {
      console.log('No children keys found.');
    }

    keys.forEach((key) => {
      console.log('Found child key:', key);
    });
  })
  .catch((error) => {
    console.log('Failed to fetch children keys:', error);
  });

// Fetch all children keys of fooRef, with an optional configuration.
firebaseChildrenKeys(fooRef, {
  maxTries: 5,
  retryInterval: 500,
  timeout: 10000,
})
  .then((keys) => {
    if (keys.length === 0) {
      console.log('No children keys found.');
    }

    keys.forEach((key) => {
      console.log('Found child key:', key);
    });
  })
  .catch((error) => {
    console.log('Failed to fetch children keys:', error);
  });