Skip to content

Commit e642fc7

Browse files
authored
Docs: mark methods and products that don't work in Node (#7276)
1 parent df8604e commit e642fc7

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

41 files changed

+201
-386
lines changed

docs-devsite/analytics.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ https://github.com/firebase/firebase-js-sdk
1010
{% endcomment %}
1111

1212
# analytics package
13-
Firebase Analytics
13+
The Firebase Analytics Web SDK. This SDK does not work in a Node.js environment.
1414

1515
## Functions
1616

docs-devsite/app-check.md

+3-1
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,9 @@ https://github.com/firebase/firebase-js-sdk
1010
{% endcomment %}
1111

1212
# app-check package
13-
Firebase App Check
13+
The Firebase App Check Web SDK.
14+
15+
Firebase App Check does not work in a Node.js environment using `ReCaptchaV3Provider` or `ReCaptchaEnterpriseProvider`<!-- -->, but can be used in Node.js if you use `CustomProvider` and write your own attestation method.
1416

1517
## Functions
1618

docs-devsite/auth.auth.md

+2
Original file line numberDiff line numberDiff line change
@@ -221,6 +221,8 @@ This will affect the currently saved Auth session and applies this type of persi
221221

222222
This makes it easy for a user signing in to specify whether their session should be remembered or not. It also makes it easier to never persist the Auth state for applications that are shared by other users or have sensitive data.
223223

224+
This method does not work in a Node.js environment.
225+
224226
<b>Signature:</b>
225227

226228
```typescript

docs-devsite/auth.md

+28
Original file line numberDiff line numberDiff line change
@@ -442,6 +442,8 @@ Returns a [UserCredential](./auth.usercredential.md#usercredential_interface) fr
442442

443443
If sign-in succeeded, returns the signed in user. If sign-in was unsuccessful, fails with an error. If no redirect operation was called, returns `null`<!-- -->.
444444

445+
This method does not work in a Node.js environment.
446+
445447
<b>Signature:</b>
446448

447449
```typescript
@@ -497,6 +499,8 @@ If initializeRecaptchaConfig() is not invoked, the auth flow will always start w
497499

498500
Thus, by calling this optional method, you will reduce the latency of future auth flows. Loading the reCAPTCHA config early will also enhance the signal collected by reCAPTCHA.
499501

502+
This method does not work in a Node.js environment.
503+
500504
<b>Signature:</b>
501505

502506
```typescript
@@ -694,6 +698,8 @@ Changes the type of persistence on the [Auth](./auth.auth.md#auth_interface) ins
694698

695699
This makes it easy for a user signing in to specify whether their session should be remembered or not. It also makes it easier to never persist the `Auth` state for applications that are shared by other users or have sensitive data.
696700

701+
This method does not work in a Node.js environment.
702+
697703
<b>Signature:</b>
698704

699705
```typescript
@@ -877,6 +883,8 @@ This method sends a code via SMS to the given phone number, and returns a [Confi
877883

878884
For abuse prevention, this method also requires a [ApplicationVerifier](./auth.applicationverifier.md#applicationverifier_interface)<!-- -->. This SDK includes a reCAPTCHA-based implementation, [RecaptchaVerifier](./auth.recaptchaverifier.md#recaptchaverifier_class)<!-- -->. This function can work on other platforms that do not support the [RecaptchaVerifier](./auth.recaptchaverifier.md#recaptchaverifier_class) (like React Native), but you need to use a third-party [ApplicationVerifier](./auth.applicationverifier.md#applicationverifier_interface) implementation.
879885

886+
This method does not work in a Node.js environment.
887+
880888
<b>Signature:</b>
881889

882890
```typescript
@@ -913,6 +921,8 @@ Authenticates a Firebase client using a popup-based OAuth authentication flow.
913921

914922
If succeeds, returns the signed in user along with the provider's credential. If sign in was unsuccessful, returns an error object containing additional information about the error.
915923

924+
This method does not work in a Node.js environment.
925+
916926
<b>Signature:</b>
917927

918928
```typescript
@@ -953,6 +963,8 @@ Authenticates a Firebase client using a full-page redirect flow.
953963

954964
To handle the results and errors for this operation, refer to [getRedirectResult()](./auth.md#getredirectresult)<!-- -->. Follow the [best practices](https://firebase.google.com/docs/auth/web/redirect-best-practices) when using [signInWithRedirect()](./auth.md#signinwithredirect)<!-- -->.
955965

966+
This method does not work in a Node.js environment.
967+
956968
<b>Signature:</b>
957969

958970
```typescript
@@ -1204,6 +1216,8 @@ Promise&lt;[UserCredential](./auth.usercredential.md#usercredential_interface)<!
12041216

12051217
Links the user account with the given phone number.
12061218

1219+
This method does not work in a Node.js environment.
1220+
12071221
<b>Signature:</b>
12081222

12091223
```typescript
@@ -1228,6 +1242,8 @@ Links the authenticated provider to the user account using a pop-up based OAuth
12281242

12291243
If the linking is successful, the returned result will contain the user and the provider's credential.
12301244

1245+
This method does not work in a Node.js environment.
1246+
12311247
<b>Signature:</b>
12321248

12331249
```typescript
@@ -1264,6 +1280,8 @@ Links the [OAuthProvider](./auth.oauthprovider.md#oauthprovider_class) to the us
12641280

12651281
To handle the results and errors for this operation, refer to [getRedirectResult()](./auth.md#getredirectresult)<!-- -->. Follow the [best practices](https://firebase.google.com/docs/auth/web/redirect-best-practices) when using [linkWithRedirect()](./auth.md#linkwithredirect)<!-- -->.
12661282

1283+
This method does not work in a Node.js environment.
1284+
12671285
<b>Signature:</b>
12681286

12691287
```typescript
@@ -1349,6 +1367,8 @@ Re-authenticates a user using a fresh phone credential.
13491367

13501368
Use before operations such as [updatePassword()](./auth.md#updatepassword) that require tokens from recent sign-in attempts.
13511369

1370+
This method does not work in a Node.js environment.
1371+
13521372
<b>Signature:</b>
13531373

13541374
```typescript
@@ -1373,6 +1393,8 @@ Reauthenticates the current user with the specified [OAuthProvider](./auth.oauth
13731393

13741394
If the reauthentication is successful, the returned result will contain the user and the provider's credential.
13751395

1396+
This method does not work in a Node.js environment.
1397+
13761398
<b>Signature:</b>
13771399

13781400
```typescript
@@ -1409,6 +1431,8 @@ Reauthenticates the current user with the specified [OAuthProvider](./auth.oauth
14091431

14101432
To handle the results and errors for this operation, refer to [getRedirectResult()](./auth.md#getredirectresult)<!-- -->. Follow the [best practices](https://firebase.google.com/docs/auth/web/redirect-best-practices) when using [reauthenticateWithRedirect()](./auth.md#reauthenticatewithredirect)<!-- -->.
14111433

1434+
This method does not work in a Node.js environment.
1435+
14121436
<b>Signature:</b>
14131437

14141438
```typescript
@@ -1585,6 +1609,8 @@ Promise&lt;void&gt;
15851609

15861610
Updates the user's phone number.
15871611

1612+
This method does not work in a Node.js environment.
1613+
15881614
<b>Signature:</b>
15891615

15901616
```typescript
@@ -1855,6 +1881,8 @@ browserLocalPersistence: Persistence
18551881

18561882
An implementation of [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface) suitable for browser based applications.
18571883

1884+
This method does not work in a Node.js environment.
1885+
18581886
<b>Signature:</b>
18591887

18601888
```typescript

docs-devsite/auth.phoneauthprovider.md

+2
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,8 @@ https://github.com/firebase/firebase-js-sdk
1212
# PhoneAuthProvider class
1313
Provider for generating an [PhoneAuthCredential](./auth.phoneauthcredential.md#phoneauthcredential_class)<!-- -->.
1414

15+
`PhoneAuthProvider` does not work in a Node.js environment.
16+
1517
<b>Signature:</b>
1618

1719
```typescript

docs-devsite/auth.phonemultifactorgenerator.md

+2
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,8 @@ static FACTOR_ID: string;
4444

4545
Provides a [PhoneMultiFactorAssertion](./auth.phonemultifactorassertion.md#phonemultifactorassertion_interface) to confirm ownership of the phone second factor.
4646

47+
This method does not work in a Node.js environment.
48+
4749
<b>Signature:</b>
4850

4951
```typescript

docs-devsite/auth.recaptchaverifier.md

+2
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,8 @@ https://github.com/firebase/firebase-js-sdk
1212
# RecaptchaVerifier class
1313
An [reCAPTCHA](https://www.google.com/recaptcha/)<!-- -->-based application verifier.
1414

15+
`RecaptchaVerifier` does not work in a Node.js environment.
16+
1517
<b>Signature:</b>
1618

1719
```typescript

docs-devsite/firestore_.firestoresettings.md

+6-2
Original file line numberDiff line numberDiff line change
@@ -23,8 +23,8 @@ export declare interface FirestoreSettings
2323
| Property | Type | Description |
2424
| --- | --- | --- |
2525
| [cacheSizeBytes](./firestore_.firestoresettings.md#firestoresettingscachesizebytes) | number | NOTE: This field will be deprecated in a future major release. Use <code>cache</code> field instead to specify cache size, and other cache configurations.<!-- -->An approximate cache size threshold for the on-disk data. If the cache grows beyond this size, Firestore will start removing data that hasn't been recently used. The size is not a guarantee that the cache will stay below that size, only that if the cache exceeds the given size, cleanup will be attempted.<!-- -->The default value is 40 MB. The threshold must be set to at least 1 MB, and can be set to <code>CACHE_SIZE_UNLIMITED</code> to disable garbage collection. |
26-
| [experimentalAutoDetectLongPolling](./firestore_.firestoresettings.md#firestoresettingsexperimentalautodetectlongpolling) | boolean | Configures the SDK's underlying transport (WebChannel) to automatically detect if long-polling should be used. This is very similar to <code>experimentalForceLongPolling</code>, but only uses long-polling if required.<!-- -->After having had a default value of <code>false</code> since its inception in 2019, the default value of this setting was changed in May 2023 to <code>true</code> in v9.22.0 of the Firebase JavaScript SDK. That is, auto-detection of long polling is now enabled by default. To disable it, set this setting to <code>false</code>, and please open a GitHub issue to share the problems that motivated you disabling long-polling auto-detection. |
27-
| [experimentalForceLongPolling](./firestore_.firestoresettings.md#firestoresettingsexperimentalforcelongpolling) | boolean | Forces the SDKs underlying network transport (WebChannel) to use long-polling. Each response from the backend will be closed immediately after the backend sends data (by default responses are kept open in case the backend has more data to send). This avoids incompatibility issues with certain proxies, antivirus software, etc. that incorrectly buffer traffic indefinitely. Use of this option will cause some performance degradation though.<!-- -->This setting cannot be used with <code>experimentalAutoDetectLongPolling</code> and may be removed in a future release. If you find yourself using it to work around a specific network reliability issue, please tell us about it in https://github.com/firebase/firebase-js-sdk/issues/1674. |
26+
| [experimentalAutoDetectLongPolling](./firestore_.firestoresettings.md#firestoresettingsexperimentalautodetectlongpolling) | boolean | Configures the SDK's underlying transport (WebChannel) to automatically detect if long-polling should be used. This is very similar to <code>experimentalForceLongPolling</code>, but only uses long-polling if required.<!-- -->After having had a default value of <code>false</code> since its inception in 2019, the default value of this setting was changed in May 2023 to <code>true</code> in v9.22.0 of the Firebase JavaScript SDK. That is, auto-detection of long polling is now enabled by default. To disable it, set this setting to <code>false</code>, and please open a GitHub issue to share the problems that motivated you disabling long-polling auto-detection.<!-- -->This setting cannot be used in a Node.js environment. |
27+
| [experimentalForceLongPolling](./firestore_.firestoresettings.md#firestoresettingsexperimentalforcelongpolling) | boolean | Forces the SDKs underlying network transport (WebChannel) to use long-polling. Each response from the backend will be closed immediately after the backend sends data (by default responses are kept open in case the backend has more data to send). This avoids incompatibility issues with certain proxies, antivirus software, etc. that incorrectly buffer traffic indefinitely. Use of this option will cause some performance degradation though.<!-- -->This setting cannot be used with <code>experimentalAutoDetectLongPolling</code> and may be removed in a future release. If you find yourself using it to work around a specific network reliability issue, please tell us about it in https://github.com/firebase/firebase-js-sdk/issues/1674.<!-- -->This setting cannot be used in a Node.js environment. |
2828
| [experimentalLongPollingOptions](./firestore_.firestoresettings.md#firestoresettingsexperimentallongpollingoptions) | [ExperimentalLongPollingOptions](./firestore_.experimentallongpollingoptions.md#experimentallongpollingoptions_interface) | Options that configure the SDKs underlying network transport (WebChannel) when long-polling is used.<!-- -->These options are only used if <code>experimentalForceLongPolling</code> is true or if <code>experimentalAutoDetectLongPolling</code> is true and the auto-detection determined that long-polling was needed. Otherwise, these options have no effect. |
2929
| [host](./firestore_.firestoresettings.md#firestoresettingshost) | string | The hostname to connect to. |
3030
| [ignoreUndefinedProperties](./firestore_.firestoresettings.md#firestoresettingsignoreundefinedproperties) | boolean | Whether to skip nested properties that are set to <code>undefined</code> during object serialization. If set to <code>true</code>, these properties are skipped and not written to Firestore. If set to <code>false</code> or omitted, the SDK throws an exception when it encounters properties of type <code>undefined</code>. |
@@ -51,6 +51,8 @@ Configures the SDK's underlying transport (WebChannel) to automatically detect i
5151

5252
After having had a default value of `false` since its inception in 2019, the default value of this setting was changed in May 2023 to `true` in v9.22.0 of the Firebase JavaScript SDK. That is, auto-detection of long polling is now enabled by default. To disable it, set this setting to `false`<!-- -->, and please open a GitHub issue to share the problems that motivated you disabling long-polling auto-detection.
5353

54+
This setting cannot be used in a Node.js environment.
55+
5456
<b>Signature:</b>
5557

5658
```typescript
@@ -63,6 +65,8 @@ Forces the SDK’s underlying network transport (WebChannel) to use long-polling
6365

6466
This setting cannot be used with `experimentalAutoDetectLongPolling` and may be removed in a future release. If you find yourself using it to work around a specific network reliability issue, please tell us about it in https://github.com/firebase/firebase-js-sdk/issues/1674.
6567

68+
This setting cannot be used in a Node.js environment.
69+
6670
<b>Signature:</b>
6771

6872
```typescript

0 commit comments

Comments
 (0)