Skip to content

Commit 205f9ca

Browse files
committed
Updated docsite changes
1 parent a8b208b commit 205f9ca

File tree

4 files changed

+16
-12
lines changed

4 files changed

+16
-12
lines changed

docs-devsite/database.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Firebase Realtime Database
1919
| <b>function(app, ...)</b> |
2020
| [getDatabase(app, url)](./database.md#getdatabase_d9cea01) | Returns the instance of the Realtime Database SDK that is associated with the provided [FirebaseApp](./app.firebaseapp.md#firebaseapp_interface)<!-- -->. Initializes a new instance with default settings if no instance exists or if the existing instance uses a custom database URL. |
2121
| <b>function(db, ...)</b> |
22-
| [connectDatabaseEmulator(db, host, port, options)](./database.md#connectdatabaseemulator_27b9e93) | Modify the provided instance to communicate with the Realtime Database emulator.<p>Note: This method must be called before performing any other operation. |
22+
| [connectDatabaseEmulator(db, host, port, options)](./database.md#connectdatabaseemulator_20a9664) | Modify the provided instance to communicate with the Realtime Database emulator.<p>Note: This method must be called before performing any other operation. |
2323
| [goOffline(db)](./database.md#gooffline_732b338) | Disconnects from the server (all Database operations will be completed offline).<!-- -->The client automatically maintains a persistent connection to the Database server, which will remain active indefinitely and reconnect when disconnected. However, the <code>goOffline()</code> and <code>goOnline()</code> methods may be used to control the client connection in cases where a persistent connection is undesirable.<!-- -->While offline, the client will no longer receive data updates from the Database. However, all Database operations performed locally will continue to immediately fire events, allowing your application to continue behaving normally. Additionally, each operation performed locally will automatically be queued and retried upon reconnection to the Database server.<!-- -->To reconnect to the Database and begin receiving remote events, see <code>goOnline()</code>. |
2424
| [goOnline(db)](./database.md#goonline_732b338) | Reconnects to the server and synchronizes the offline Database state with the server state.<!-- -->This method should be used after disabling the active connection with <code>goOffline()</code>. Once reconnected, the client will transmit the proper data and fire the appropriate events so that your client "catches up" automatically. |
2525
| [ref(db, path)](./database.md#ref_5f88fa2) | Returns a <code>Reference</code> representing the location in the Database corresponding to the provided path. If no path is provided, the <code>Reference</code> will point to the root of the Database. |
@@ -135,7 +135,7 @@ The `Database` instance of the provided app.
135135

136136
## function(db, ...)
137137

138-
### connectDatabaseEmulator(db, host, port, options) {:#connectdatabaseemulator_27b9e93}
138+
### connectDatabaseEmulator(db, host, port, options) {:#connectdatabaseemulator_20a9664}
139139

140140
Modify the provided instance to communicate with the Realtime Database emulator.
141141

@@ -146,6 +146,7 @@ Modify the provided instance to communicate with the Realtime Database emulator.
146146
```typescript
147147
export declare function connectDatabaseEmulator(db: Database, host: string, port: number, options?: {
148148
mockUserToken?: EmulatorMockTokenOptions | string;
149+
ssl?: boolean;
149150
}): void;
150151
```
151152

@@ -156,7 +157,7 @@ export declare function connectDatabaseEmulator(db: Database, host: string, port
156157
| db | [Database](./database.database.md#database_class) | The instance to modify. |
157158
| host | string | The emulator host (ex: localhost) |
158159
| port | number | The emulator port (ex: 8080) |
159-
| options | { mockUserToken?: [EmulatorMockTokenOptions](./util.md#emulatormocktokenoptions) \| string; } | |
160+
| options | { mockUserToken?: [EmulatorMockTokenOptions](./util.md#emulatormocktokenoptions) \| string; ssl?: boolean; } | |
160161

161162
<b>Returns:</b>
162163

docs-devsite/firestore_.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ https://github.com/firebase/firebase-js-sdk
2323
| [clearIndexedDbPersistence(firestore)](./firestore_.md#clearindexeddbpersistence_231a8e0) | Clears the persistent storage. This includes pending writes and cached documents.<!-- -->Must be called while the [Firestore](./firestore_.firestore.md#firestore_class) instance is not started (after the app is terminated or when the app is first initialized). On startup, this function must be called before other functions (other than [initializeFirestore()](./firestore_.md#initializefirestore_fc7d200) or [getFirestore()](./firestore_.md#getfirestore)<!-- -->)). If the [Firestore](./firestore_.firestore.md#firestore_class) instance is still running, the promise will be rejected with the error code of <code>failed-precondition</code>.<!-- -->Note: <code>clearIndexedDbPersistence()</code> is primarily intended to help write reliable tests that use Cloud Firestore. It uses an efficient mechanism for dropping existing data but does not attempt to securely overwrite or otherwise make cached data unrecoverable. For applications that are sensitive to the disclosure of cached data in between user sessions, we strongly recommend not enabling persistence at all. |
2424
| [collection(firestore, path, pathSegments)](./firestore_.md#collection_1eb4c23) | Gets a <code>CollectionReference</code> instance that refers to the collection at the specified absolute path. |
2525
| [collectionGroup(firestore, collectionId)](./firestore_.md#collectiongroup_1838fc3) | Creates and returns a new <code>Query</code> instance that includes all documents in the database that are contained in a collection or subcollection with the given <code>collectionId</code>. |
26-
| [connectFirestoreEmulator(firestore, host, port, options)](./firestore_.md#connectfirestoreemulator_7c247cd) | Modify this instance to communicate with the Cloud Firestore emulator.<!-- -->Note: This must be called before this instance has been used to do any operations. |
26+
| [connectFirestoreEmulator(firestore, host, port, options)](./firestore_.md#connectfirestoreemulator_6c8868a) | Modify this instance to communicate with the Cloud Firestore emulator.<!-- -->Note: This must be called before this instance has been used to do any operations. |
2727
| [disableNetwork(firestore)](./firestore_.md#disablenetwork_231a8e0) | Disables network usage for this instance. It can be re-enabled via [enableNetwork()](./firestore_.md#enablenetwork_231a8e0)<!-- -->. While the network is disabled, any snapshot listeners, <code>getDoc()</code> or <code>getDocs()</code> calls will return results from cache, and any write operations will be queued until the network is restored. |
2828
| [doc(firestore, path, pathSegments)](./firestore_.md#doc_1eb4c23) | Gets a <code>DocumentReference</code> instance that refers to the document at the specified absolute path. |
2929
| [enableIndexedDbPersistence(firestore, persistenceSettings)](./firestore_.md#enableindexeddbpersistence_224174f) | Attempts to enable persistent storage, if possible.<!-- -->On failure, <code>enableIndexedDbPersistence()</code> will reject the promise or throw an exception. There are several reasons why this can fail, which can be identified by the <code>code</code> on the error.<!-- -->\* failed-precondition: The app is already open in another browser tab. \* unimplemented: The browser is incompatible with the offline persistence implementation.<!-- -->Note that even after a failure, the [Firestore](./firestore_.firestore.md#firestore_class) instance will remain usable, however offline persistence will be disabled.<!-- -->Note: <code>enableIndexedDbPersistence()</code> must be called before any other functions (other than [initializeFirestore()](./firestore_.md#initializefirestore_fc7d200)<!-- -->, [getFirestore()](./firestore_.md#getfirestore) or [clearIndexedDbPersistence()](./firestore_.md#clearindexeddbpersistence_231a8e0)<!-- -->.<!-- -->Persistence cannot be used in a Node.js environment. |
@@ -377,7 +377,7 @@ export declare function collectionGroup(firestore: Firestore, collectionId: stri
377377

378378
The created `Query`<!-- -->.
379379

380-
### connectFirestoreEmulator(firestore, host, port, options) {:#connectfirestoreemulator_7c247cd}
380+
### connectFirestoreEmulator(firestore, host, port, options) {:#connectfirestoreemulator_6c8868a}
381381

382382
Modify this instance to communicate with the Cloud Firestore emulator.
383383

@@ -388,6 +388,7 @@ Note: This must be called before this instance has been used to do any operation
388388
```typescript
389389
export declare function connectFirestoreEmulator(firestore: Firestore, host: string, port: number, options?: {
390390
mockUserToken?: EmulatorMockTokenOptions | string;
391+
ssl?: boolean;
391392
}): void;
392393
```
393394

@@ -398,7 +399,7 @@ export declare function connectFirestoreEmulator(firestore: Firestore, host: str
398399
| firestore | [Firestore](./firestore_.firestore.md#firestore_class) | The <code>Firestore</code> instance to configure to connect to the emulator. |
399400
| host | string | the emulator host (ex: localhost). |
400401
| port | number | the emulator port (ex: 9000). |
401-
| options | { mockUserToken?: [EmulatorMockTokenOptions](./util.md#emulatormocktokenoptions) \| string; } | |
402+
| options | { mockUserToken?: [EmulatorMockTokenOptions](./util.md#emulatormocktokenoptions) \| string; ssl?: boolean; } | |
402403

403404
<b>Returns:</b>
404405

docs-devsite/firestore_lite.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ https://github.com/firebase/firebase-js-sdk
2323
| <b>function(firestore, ...)</b> |
2424
| [collection(firestore, path, pathSegments)](./firestore_lite.md#collection_1eb4c23) | Gets a <code>CollectionReference</code> instance that refers to the collection at the specified absolute path. |
2525
| [collectionGroup(firestore, collectionId)](./firestore_lite.md#collectiongroup_1838fc3) | Creates and returns a new <code>Query</code> instance that includes all documents in the database that are contained in a collection or subcollection with the given <code>collectionId</code>. |
26-
| [connectFirestoreEmulator(firestore, host, port, options)](./firestore_lite.md#connectfirestoreemulator_7c247cd) | Modify this instance to communicate with the Cloud Firestore emulator.<!-- -->Note: This must be called before this instance has been used to do any operations. |
26+
| [connectFirestoreEmulator(firestore, host, port, options)](./firestore_lite.md#connectfirestoreemulator_6c8868a) | Modify this instance to communicate with the Cloud Firestore emulator.<!-- -->Note: This must be called before this instance has been used to do any operations. |
2727
| [doc(firestore, path, pathSegments)](./firestore_lite.md#doc_1eb4c23) | Gets a <code>DocumentReference</code> instance that refers to the document at the specified absolute path. |
2828
| [runTransaction(firestore, updateFunction, options)](./firestore_lite.md#runtransaction_6f03ec4) | Executes the given <code>updateFunction</code> and then attempts to commit the changes applied within the transaction. If any document read within the transaction has changed, Cloud Firestore retries the <code>updateFunction</code>. If it fails to commit after 5 attempts, the transaction fails.<!-- -->The maximum number of writes allowed in a single transaction is 500. |
2929
| [terminate(firestore)](./firestore_lite.md#terminate_231a8e0) | Terminates the provided <code>Firestore</code> instance.<!-- -->After calling <code>terminate()</code> only the <code>clearIndexedDbPersistence()</code> functions may be used. Any other function will throw a <code>FirestoreError</code>. Termination does not cancel any pending writes, and any promises that are awaiting a response from the server will not be resolved.<!-- -->To restart after termination, create a new instance of <code>Firestore</code> with [getFirestore()](./firestore_.md#getfirestore)<!-- -->.<!-- -->Note: Under normal circumstances, calling <code>terminate()</code> is not required. This function is useful only when you want to force this instance to release all of its resources or in combination with [clearIndexedDbPersistence()](./firestore_.md#clearindexeddbpersistence_231a8e0) to ensure that all local state is destroyed between test runs. |
@@ -308,7 +308,7 @@ export declare function collectionGroup(firestore: Firestore, collectionId: stri
308308

309309
The created `Query`<!-- -->.
310310

311-
### connectFirestoreEmulator(firestore, host, port, options) {:#connectfirestoreemulator_7c247cd}
311+
### connectFirestoreEmulator(firestore, host, port, options) {:#connectfirestoreemulator_6c8868a}
312312

313313
Modify this instance to communicate with the Cloud Firestore emulator.
314314

@@ -319,6 +319,7 @@ Note: This must be called before this instance has been used to do any operation
319319
```typescript
320320
export declare function connectFirestoreEmulator(firestore: Firestore, host: string, port: number, options?: {
321321
mockUserToken?: EmulatorMockTokenOptions | string;
322+
ssl?: boolean;
322323
}): void;
323324
```
324325

@@ -329,7 +330,7 @@ export declare function connectFirestoreEmulator(firestore: Firestore, host: str
329330
| firestore | [Firestore](./firestore_lite.firestore.md#firestore_class) | The <code>Firestore</code> instance to configure to connect to the emulator. |
330331
| host | string | the emulator host (ex: localhost). |
331332
| port | number | the emulator port (ex: 9000). |
332-
| options | { mockUserToken?: [EmulatorMockTokenOptions](./util.md#emulatormocktokenoptions) \| string; } | |
333+
| options | { mockUserToken?: [EmulatorMockTokenOptions](./util.md#emulatormocktokenoptions) \| string; ssl?: boolean; } | |
333334

334335
<b>Returns:</b>
335336

docs-devsite/functions.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Cloud Functions for Firebase
1919
| <b>function(app, ...)</b> |
2020
| [getFunctions(app, regionOrCustomDomain)](./functions.md#getfunctions_60f2095) | Returns a [Functions](./functions.functions.md#functions_interface) instance for the given app. |
2121
| <b>function(functionsInstance, ...)</b> |
22-
| [connectFunctionsEmulator(functionsInstance, host, port)](./functions.md#connectfunctionsemulator_505c08d) | Modify this instance to communicate with the Cloud Functions emulator.<!-- -->Note: this must be called before this instance has been used to do any operations. |
22+
| [connectFunctionsEmulator(functionsInstance, host, port, ssl)](./functions.md#connectfunctionsemulator_a989598) | Modify this instance to communicate with the Cloud Functions emulator.<!-- -->Note: this must be called before this instance has been used to do any operations. |
2323
| [httpsCallable(functionsInstance, name, options)](./functions.md#httpscallable_1dd297c) | Returns a reference to the callable HTTPS trigger with the given name. |
2424
| [httpsCallableFromURL(functionsInstance, url, options)](./functions.md#httpscallablefromurl_7af6987) | Returns a reference to the callable HTTPS trigger with the specified url. |
2525

@@ -72,7 +72,7 @@ export declare function getFunctions(app?: FirebaseApp, regionOrCustomDomain?: s
7272

7373
## function(functionsInstance, ...)
7474

75-
### connectFunctionsEmulator(functionsInstance, host, port) {:#connectfunctionsemulator_505c08d}
75+
### connectFunctionsEmulator(functionsInstance, host, port, ssl) {:#connectfunctionsemulator_a989598}
7676

7777
Modify this instance to communicate with the Cloud Functions emulator.
7878

@@ -81,7 +81,7 @@ Note: this must be called before this instance has been used to do any operation
8181
<b>Signature:</b>
8282

8383
```typescript
84-
export declare function connectFunctionsEmulator(functionsInstance: Functions, host: string, port: number): void;
84+
export declare function connectFunctionsEmulator(functionsInstance: Functions, host: string, port: number, ssl?: boolean): void;
8585
```
8686

8787
#### Parameters
@@ -91,6 +91,7 @@ export declare function connectFunctionsEmulator(functionsInstance: Functions, h
9191
| functionsInstance | [Functions](./functions.functions.md#functions_interface) | |
9292
| host | string | The emulator host (ex: localhost) |
9393
| port | number | The emulator port (ex: 5001) |
94+
| ssl | boolean | |
9495

9596
<b>Returns:</b>
9697

0 commit comments

Comments
 (0)