Back to Firebase Js Sdk

PipelineExecuteOptions interface

docs-devsite/firestore_pipelines.pipelineexecuteoptions.md

12.12.13.0 KB
Original Source

Project: /docs/reference/js/_project.yaml Book: /docs/reference/_book.yaml page_type: reference

{% comment %} DO NOT EDIT THIS FILE! This is generated by the JS SDK team, and any local changes will be overwritten. Changes should be made in the source code at https://github.com/firebase/firebase-js-sdk {% endcomment %}

PipelineExecuteOptions interface

Options defining Pipeline execution.

<b>Signature:</b>

typescript
export declare interface PipelineExecuteOptions 

Properties

PropertyTypeDescription
indexMode'recommended'Specify the index mode.
pipelinePipelinePipeline to be evaluated.
rawOptions{ [name: string]: unknown; }An escape hatch to set options not known at SDK build time. These values will be passed directly to the Firestore backend and not used by the SDK.<!-- -->The option name will be used as provided. And must match the name format used by the backend (hint: use a snake_case_name).<!-- -->Custom option values can be any type supported by Firestore (for example: string, boolean, number, map, …). Value types not known to the SDK will be rejected.<!-- -->Values specified in rawOptions will take precedence over any options with the same name set by the SDK.

PipelineExecuteOptions.indexMode

Specify the index mode.

<b>Signature:</b>

typescript
indexMode?: 'recommended';

PipelineExecuteOptions.pipeline

Pipeline to be evaluated.

<b>Signature:</b>

typescript
pipeline: Pipeline;

PipelineExecuteOptions.rawOptions

An escape hatch to set options not known at SDK build time. These values will be passed directly to the Firestore backend and not used by the SDK.

The option name will be used as provided. And must match the name format used by the backend (hint: use a snake_case_name).

Custom option values can be any type supported by Firestore (for example: string, boolean, number, map, …). Value types not known to the SDK will be rejected.

Values specified in rawOptions will take precedence over any options with the same name set by the SDK.

<b>Signature:</b>

typescript
rawOptions?: {
        [name: string]: unknown;
    };

Example

Override the example_option<!-- -->:

  execute({
    pipeline: myPipeline,
    rawOptions: {
      // Override `example_option`. This will not
      // merge with the existing `example_option` object.
      "example_option": {
        foo: "bar"
      }
    }
  }

rawOptions supports dot notation, if you want to override a nested option.

  execute({
    pipeline: myPipeline,
    rawOptions: {
      // Override `example_option.foo` and do not override
      // any other properties of `example_option`.
      "example_option.foo": "bar"
    }
  }