Skip to content

Commit a6ebdc9

Browse files
committed
Run v9 docgen
1 parent 6399504 commit a6ebdc9

File tree

9 files changed

+40
-35
lines changed

9 files changed

+40
-35
lines changed

docs-devsite/analytics.md

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

1212
# analytics package
13-
The Firebase Analytics Web SDK.
14-
15-
The Firebase Analytics Web SDK currently does not work in Node.js.
13+
The Firebase Analytics Web SDK. This SDK currently does not work in Node.js.
1614

1715
## Functions
1816

docs-devsite/auth.md

Lines changed: 26 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ Firebase Authentication
5757
| [getIdToken(user, forceRefresh)](./auth.md#getidtoken) | Returns a JSON Web Token (JWT) used to identify the user to a Firebase service. |
5858
| [getIdTokenResult(user, forceRefresh)](./auth.md#getidtokenresult) | Returns a deserialized JSON Web Token (JWT) used to identify the user to a Firebase service. |
5959
| [linkWithCredential(user, credential)](./auth.md#linkwithcredential) | Links the user account with the given credentials. |
60-
| [linkWithPhoneNumber(user, phoneNumber, appVerifier)](./auth.md#linkwithphonenumber) | Links the user account with the given phone number.<!-- -->This method is not available in Node.js. |
60+
| [linkWithPhoneNumber(user, phoneNumber, appVerifier)](./auth.md#linkwithphonenumber) | Links the user account with the given phone number. |
6161
| [linkWithPopup(user, provider, resolver)](./auth.md#linkwithpopup) | Links the authenticated provider to the user account using a pop-up based OAuth flow. |
6262
| [linkWithRedirect(user, provider, resolver)](./auth.md#linkwithredirect) | Links the [OAuthProvider](./auth.oauthprovider.md#oauthprovider_class) to the user account using a full-page redirect flow. |
6363
| [multiFactor(user)](./auth.md#multifactor) | The [MultiFactorUser](./auth.multifactoruser.md#multifactoruser_interface) corresponding to the user. |
@@ -92,7 +92,7 @@ Firebase Authentication
9292
| [PhoneAuthCredential](./auth.phoneauthcredential.md#phoneauthcredential_class) | Represents the credentials returned by [PhoneAuthProvider](./auth.phoneauthprovider.md#phoneauthprovider_class)<!-- -->. |
9393
| [PhoneAuthProvider](./auth.phoneauthprovider.md#phoneauthprovider_class) | Provider for generating an [PhoneAuthCredential](./auth.phoneauthcredential.md#phoneauthcredential_class)<!-- -->. |
9494
| [PhoneMultiFactorGenerator](./auth.phonemultifactorgenerator.md#phonemultifactorgenerator_class) | Provider for generating a [PhoneMultiFactorAssertion](./auth.phonemultifactorassertion.md#phonemultifactorassertion_interface)<!-- -->. |
95-
| [RecaptchaVerifier](./auth.recaptchaverifier.md#recaptchaverifier_class) | An [reCAPTCHA](https://www.google.com/recaptcha/)<!-- -->-based application verifier.<code>RecaptchaVerifier</code> is not available in Node.js. |
95+
| [RecaptchaVerifier](./auth.recaptchaverifier.md#recaptchaverifier_class) | An [reCAPTCHA](https://www.google.com/recaptcha/)<!-- -->-based application verifier. |
9696
| [SAMLAuthProvider](./auth.samlauthprovider.md#samlauthprovider_class) | An [AuthProvider](./auth.authprovider.md#authprovider_interface) for SAML. |
9797
| [TotpMultiFactorGenerator](./auth.totpmultifactorgenerator.md#totpmultifactorgenerator_class) | Provider for generating a [TotpMultiFactorAssertion](./auth.totpmultifactorassertion.md#totpmultifactorassertion_interface)<!-- -->. |
9898
| [TotpSecret](./auth.totpsecret.md#totpsecret_class) | Provider for generating a [TotpMultiFactorAssertion](./auth.totpmultifactorassertion.md#totpmultifactorassertion_interface)<!-- -->.<!-- -->Stores the shared secret key and other parameters to generate time-based OTPs. Implements methods to retrieve the shared secret key and generate a QR code URL. |
@@ -147,7 +147,7 @@ Firebase Authentication
147147
| [ActionCodeOperation](./auth.md#actioncodeoperation) | An enumeration of the possible email action types. |
148148
| [AuthErrorCodes](./auth.md#autherrorcodes) | A map of potential <code>Auth</code> error codes, for easier comparison with errors thrown by the SDK. |
149149
| [browserLocalPersistence](./auth.md#browserlocalpersistence) | An implementation of [Persistence](./auth.persistence.md#persistence_interface) of type <code>LOCAL</code> using <code>localStorage</code> for the underlying storage. |
150-
| [browserPopupRedirectResolver](./auth.md#browserpopupredirectresolver) | An implementation of [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface) suitable for browser based applications.<!-- -->This method is not available in Node.js. |
150+
| [browserPopupRedirectResolver](./auth.md#browserpopupredirectresolver) | An implementation of [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface) suitable for browser based applications. |
151151
| [browserSessionPersistence](./auth.md#browsersessionpersistence) | An implementation of [Persistence](./auth.persistence.md#persistence_interface) of <code>SESSION</code> using <code>sessionStorage</code> for the underlying storage. |
152152
| [cordovaPopupRedirectResolver](./auth.md#cordovapopupredirectresolver) | An implementation of [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface) suitable for Cordova based applications. |
153153
| [debugErrorMap](./auth.md#debugerrormap) | A verbose error map with detailed descriptions for most error codes.<!-- -->See discussion at [AuthErrorMap](./auth.autherrormap.md#autherrormap_interface) |
@@ -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 is not available in Node.js.
446+
445447
<b>Signature:</b>
446448

447449
```typescript
@@ -453,7 +455,7 @@ export declare function getRedirectResult(auth: Auth, resolver?: PopupRedirectRe
453455
| Parameter | Type | Description |
454456
| --- | --- | --- |
455457
| auth | [Auth](./auth.auth.md#auth_interface) | The [Auth](./auth.auth.md#auth_interface) instance. |
456-
| resolver | [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface) | An instance of [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface)<!-- -->, optional if already supplied to [initializeAuth()](./auth.md#initializeauth) or provided by [getAuth()](./auth.md#getauth)<!-- -->.<!-- -->This method is not available in Node.js. |
458+
| resolver | [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface) | An instance of [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface)<!-- -->, optional if already supplied to [initializeAuth()](./auth.md#initializeauth) or provided by [getAuth()](./auth.md#getauth)<!-- -->. |
457459

458460
<b>Returns:</b>
459461

@@ -878,6 +880,8 @@ This method sends a code via SMS to the given phone number, and returns a [Confi
878880

879881
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.
880882

883+
This method is not available in Node.js.
884+
881885
<b>Signature:</b>
882886

883887
```typescript
@@ -907,14 +911,15 @@ const confirmationResult = await signInWithPhoneNumber(auth, phoneNumber, applic
907911
const credential = await confirmationResult.confirm(verificationCode);
908912

909913
```
910-
This method is not available in Node.js.
911914

912915
## signInWithPopup()
913916

914917
Authenticates a Firebase client using a popup-based OAuth authentication flow.
915918

916919
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.
917920

921+
This method is not available in Node.js.
922+
918923
<b>Signature:</b>
919924

920925
```typescript
@@ -927,7 +932,7 @@ export declare function signInWithPopup(auth: Auth, provider: AuthProvider, reso
927932
| --- | --- | --- |
928933
| auth | [Auth](./auth.auth.md#auth_interface) | The [Auth](./auth.auth.md#auth_interface) instance. |
929934
| provider | [AuthProvider](./auth.authprovider.md#authprovider_interface) | The provider to authenticate. The provider has to be an [OAuthProvider](./auth.oauthprovider.md#oauthprovider_class)<!-- -->. Non-OAuth providers like [EmailAuthProvider](./auth.emailauthprovider.md#emailauthprovider_class) will throw an error. |
930-
| resolver | [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface) | An instance of [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface)<!-- -->, optional if already supplied to [initializeAuth()](./auth.md#initializeauth) or provided by [getAuth()](./auth.md#getauth)<!-- -->.<!-- -->This method is not available in Node.js. |
935+
| resolver | [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface) | An instance of [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface)<!-- -->, optional if already supplied to [initializeAuth()](./auth.md#initializeauth) or provided by [getAuth()](./auth.md#getauth)<!-- -->. |
931936

932937
<b>Returns:</b>
933938

@@ -955,6 +960,8 @@ Authenticates a Firebase client using a full-page redirect flow.
955960

956961
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)<!-- -->.
957962

963+
This method is not available in Node.js.
964+
958965
<b>Signature:</b>
959966

960967
```typescript
@@ -967,7 +974,7 @@ export declare function signInWithRedirect(auth: Auth, provider: AuthProvider, r
967974
| --- | --- | --- |
968975
| auth | [Auth](./auth.auth.md#auth_interface) | The [Auth](./auth.auth.md#auth_interface) instance. |
969976
| provider | [AuthProvider](./auth.authprovider.md#authprovider_interface) | The provider to authenticate. The provider has to be an [OAuthProvider](./auth.oauthprovider.md#oauthprovider_class)<!-- -->. Non-OAuth providers like [EmailAuthProvider](./auth.emailauthprovider.md#emailauthprovider_class) will throw an error. |
970-
| resolver | [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface) | An instance of [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface)<!-- -->, optional if already supplied to [initializeAuth()](./auth.md#initializeauth) or provided by [getAuth()](./auth.md#getauth)<!-- -->.<!-- -->This method is not available in Node.js. |
977+
| resolver | [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface) | An instance of [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface)<!-- -->, optional if already supplied to [initializeAuth()](./auth.md#initializeauth) or provided by [getAuth()](./auth.md#getauth)<!-- -->. |
971978

972979
<b>Returns:</b>
973980

@@ -1232,6 +1239,8 @@ Links the authenticated provider to the user account using a pop-up based OAuth
12321239

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

1242+
This method is not available in Node.js.
1243+
12351244
<b>Signature:</b>
12361245

12371246
```typescript
@@ -1261,14 +1270,15 @@ const provider = new FacebookAuthProvider();
12611270
await linkWithPopup(result.user, provider);
12621271

12631272
```
1264-
This method is not available in Node.js.
12651273

12661274
## linkWithRedirect()
12671275

12681276
Links the [OAuthProvider](./auth.oauthprovider.md#oauthprovider_class) to the user account using a full-page redirect flow.
12691277

12701278
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)<!-- -->.
12711279

1280+
This method is not available in Node.js.
1281+
12721282
<b>Signature:</b>
12731283

12741284
```typescript
@@ -1281,7 +1291,7 @@ export declare function linkWithRedirect(user: User, provider: AuthProvider, res
12811291
| --- | --- | --- |
12821292
| user | [User](./auth.user.md#user_interface) | The user. |
12831293
| provider | [AuthProvider](./auth.authprovider.md#authprovider_interface) | The provider to authenticate. The provider has to be an [OAuthProvider](./auth.oauthprovider.md#oauthprovider_class)<!-- -->. Non-OAuth providers like [EmailAuthProvider](./auth.emailauthprovider.md#emailauthprovider_class) will throw an error. |
1284-
| resolver | [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface) | An instance of [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface)<!-- -->, optional if already supplied to [initializeAuth()](./auth.md#initializeauth) or provided by [getAuth()](./auth.md#getauth)<!-- -->.<!-- -->This method is not available in Node.js. |
1294+
| resolver | [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface) | An instance of [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface)<!-- -->, optional if already supplied to [initializeAuth()](./auth.md#initializeauth) or provided by [getAuth()](./auth.md#getauth)<!-- -->. |
12851295

12861296
<b>Returns:</b>
12871297

@@ -1380,6 +1390,8 @@ Reauthenticates the current user with the specified [OAuthProvider](./auth.oauth
13801390

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

1393+
This method is not available in Node.js.
1394+
13831395
<b>Signature:</b>
13841396

13851397
```typescript
@@ -1409,14 +1421,15 @@ const result = await signInWithPopup(auth, provider);
14091421
await reauthenticateWithPopup(result.user, provider);
14101422

14111423
```
1412-
This method is not available in Node.js.
14131424

14141425
## reauthenticateWithRedirect()
14151426

14161427
Reauthenticates the current user with the specified [OAuthProvider](./auth.oauthprovider.md#oauthprovider_class) using a full-page redirect flow.
14171428

14181429
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)<!-- -->.
14191430

1431+
This method is not available in Node.js.
1432+
14201433
<b>Signature:</b>
14211434

14221435
```typescript
@@ -1429,7 +1442,7 @@ export declare function reauthenticateWithRedirect(user: User, provider: AuthPro
14291442
| --- | --- | --- |
14301443
| user | [User](./auth.user.md#user_interface) | The user. |
14311444
| provider | [AuthProvider](./auth.authprovider.md#authprovider_interface) | The provider to authenticate. The provider has to be an [OAuthProvider](./auth.oauthprovider.md#oauthprovider_class)<!-- -->. Non-OAuth providers like [EmailAuthProvider](./auth.emailauthprovider.md#emailauthprovider_class) will throw an error. |
1432-
| resolver | [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface) | An instance of [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface)<!-- -->, optional if already supplied to [initializeAuth()](./auth.md#initializeauth) or provided by [getAuth()](./auth.md#getauth)<!-- -->.<!-- -->This method is not available in Node.js. |
1445+
| resolver | [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface) | An instance of [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface)<!-- -->, optional if already supplied to [initializeAuth()](./auth.md#initializeauth) or provided by [getAuth()](./auth.md#getauth)<!-- -->. |
14331446

14341447
<b>Returns:</b>
14351448

@@ -1593,6 +1606,8 @@ Promise&lt;void&gt;
15931606

15941607
Updates the user's phone number.
15951608

1609+
This method is not available in Node.js.
1610+
15961611
<b>Signature:</b>
15971612

15981613
```typescript
@@ -1623,7 +1638,6 @@ const phoneCredential = PhoneAuthProvider.credential(verificationId, verificatio
16231638
await updatePhoneNumber(user, phoneCredential);
16241639
16251640
```
1626-
This method is not available in Node.js.
16271641

16281642
## updateProfile()
16291643

docs-devsite/auth.phoneauthprovider.md

Lines changed: 2 additions & 1 deletion
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` is not available in Node.js.
16+
1517
<b>Signature:</b>
1618

1719
```typescript
@@ -253,5 +255,4 @@ const phoneCredential = PhoneAuthProvider.credential(verificationId, verificatio
253255
const userCredential = await signInWithCredential(auth, phoneCredential);
254256

255257
```
256-
`PhoneAuthProvider` is not available in Node.js.
257258

docs-devsite/auth.phonemultifactorgenerator.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ export declare class PhoneMultiFactorGenerator
2828

2929
| Method | Modifiers | Description |
3030
| --- | --- | --- |
31-
| [assertion(credential)](./auth.phonemultifactorgenerator.md#phonemultifactorgeneratorassertion) | <code>static</code> | Provides a [PhoneMultiFactorAssertion](./auth.phonemultifactorassertion.md#phonemultifactorassertion_interface) to confirm ownership of the phone second factor.<!-- -->This method is not available in Node.js. |
31+
| [assertion(credential)](./auth.phonemultifactorgenerator.md#phonemultifactorgeneratorassertion) | <code>static</code> | Provides a [PhoneMultiFactorAssertion](./auth.phonemultifactorassertion.md#phonemultifactorassertion_interface) to confirm ownership of the phone second factor. |
3232

3333
## PhoneMultiFactorGenerator.FACTOR\_ID
3434

docs-devsite/index.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -15,16 +15,16 @@ https://github.com/firebase/firebase-js-sdk
1515

1616
| Package | Description |
1717
| --- | --- |
18-
| [@firebase/analytics](./analytics.md#analytics_package) | The Firebase Analytics Web SDK.<!-- -->The Firebase Analytics Web SDK currently does not work in Node.js. |
18+
| [@firebase/analytics](./analytics.md#analytics_package) | The Firebase Analytics Web SDK. This SDK currently does not work in Node.js. |
1919
| [@firebase/app](./app.md#app_package) | Firebase App |
20-
| [@firebase/app-check](./app-check.md#app-check_package) | The Firebase App Check Web SDK.<!-- -->Firebase App Check does not work in Node.js using <code>ReCaptchaV3Provider</code> or <code>ReCaptchaEnterpriseProvider</code>, but can be used in Node.js if you use <code>CustomProvider</code> and write your own attestation method. |
20+
| [@firebase/app-check](./app-check.md#app-check_package) | The Firebase App Check Web SDK. |
2121
| [@firebase/auth](./auth.md#auth_package) | Firebase Authentication |
2222
| [@firebase/database](./database.md#database_package) | Firebase Realtime Database |
2323
| [@firebase/firestore](./firestore.md#firestore_package) | Cloud Firestore |
2424
| [@firebase/functions](./functions.md#functions_package) | Cloud Functions for Firebase |
25-
| [@firebase/installations](./installations.md#installations_package) | The Firebase Installations Web SDK.<!-- -->The Firebase Installations Web SDK currently does not work in Node.js. |
26-
| [@firebase/messaging](./messaging.md#messaging_package) | The Firebase Cloud Messaging Web SDK.<!-- -->The Firebase Cloud Messaging Web SDK currently does not work in Node.js. |
27-
| [@firebase/performance](./performance.md#performance_package) | The Firebase Performance Monitoring Web SDK.<!-- -->The Firebase Performance Monitoring Web SDK currently does not work in Node.js. |
28-
| [@firebase/remote-config](./remote-config.md#remote-config_package) | The Firebase Remote Config Web SDK.<!-- -->The Firebase Remote Config Web SDK currently does not work in Node.js. |
25+
| [@firebase/installations](./installations.md#installations_package) | The Firebase Installations Web SDK. This SDK currently does not work in Node.js. |
26+
| [@firebase/messaging](./messaging.md#messaging_package) | The Firebase Cloud Messaging Web SDK. This SDK currently does not work in Node.js. |
27+
| [@firebase/performance](./performance.md#performance_package) | The Firebase Performance Monitoring Web SDK. This SDK currently does not work in Node.js. |
28+
| [@firebase/remote-config](./remote-config.md#remote-config_package) | The Firebase Remote Config Web SDK. This SDK currently does not work in Node.js. |
2929
| [@firebase/storage](./storage.md#storage_package) | Cloud Storage for Firebase |
3030

docs-devsite/installations.md

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

1212
# installations package
13-
The Firebase Installations Web SDK.
14-
15-
The Firebase Installations Web SDK currently does not work in Node.js.
13+
The Firebase Installations Web SDK. This SDK currently does not work in Node.js.
1614

1715
## Functions
1816

0 commit comments

Comments
 (0)