@throws clauses.

Author: DellaBitta

docs-devsite/app.md

@@ -142,6 +142,14 @@ export declare function initializeServerApp(config?: FirebaseServerAppSettings):
 
 The initialized `FirebaseServerApp`<!-- -->.
 
+#### Exceptions
+
+If invoked in an unsupported non-server environment such as a browser.
+
+If [FirebaseServerAppSettings.releaseOnDeref](./app.firebaseserverappsettings.md#firebaseserverappsettingsreleaseonderef) is defined but the runtime doesn't provide Finalization Registry support.
+
+If the `FIREBASE_OPTIONS` enviornment variable does not contain a valid project configuration required for auto-initialization.
+
 ## function(libraryKeyOrName, ...)
 
 ### registerVersion(libraryKeyOrName, version, variant) {:#registerversion_f673248}
@@ -286,6 +294,12 @@ export declare function initializeApp(options: FirebaseOptions, name?: string):
 
 The initialized app.
 
+#### Exceptions
+
+If the optional `name` parameter is malformed or empty.
+
+If a `FirebaseApp` already exists with the same name but with a different configuration.
+
 ### Example 1
 
 
@@ -338,6 +352,12 @@ export declare function initializeApp(options: FirebaseOptions, config?: Firebas
 
 [FirebaseApp](./app.firebaseapp.md#firebaseapp_interface)
 
+#### Exceptions
+
+If [FirebaseAppSettings.name](./app.firebaseappsettings.md#firebaseappsettingsname) is defined but the value is malformed or empty.
+
+If a `FirebaseApp` already exists with the same name but with a different configuration.
+
 ### initializeServerApp(options, config) {:#initializeserverapp_30ab697}
 
 Creates and initializes a [FirebaseServerApp](./app.firebaseserverapp.md#firebaseserverapp_interface) instance.
@@ -365,6 +385,12 @@ export declare function initializeServerApp(options: FirebaseOptions | FirebaseA
 
 The initialized `FirebaseServerApp`<!-- -->.
 
+#### Exceptions
+
+If invoked in an unsupported non-server environment such as a browser.
+
+If [FirebaseServerAppSettings.releaseOnDeref](./app.firebaseserverappsettings.md#firebaseserverappsettingsreleaseonderef) is defined but the runtime doesn't provide Finalization Registry support.
+
 ### Example
 
 

packages/app/src/api.ts

@@ -106,6 +106,10 @@ export const SDK_VERSION = version;
  *   is provided, the default is `"[DEFAULT]"`.
  *
  * @returns The initialized app.
+ * 
+ * @throws If the optional `name` parameter is malformed or empty.
+ * 
+ * @throws If a `FirebaseApp` already exists with the same name but with a different configuration.
  *
  * @public
  */
@@ -119,6 +123,9 @@ export function initializeApp(
  * @param options - Options to configure the app's services.
  * @param config - FirebaseApp Configuration
  *
+ * @throws If {@link FirebaseAppSettings.name} is defined but the value is malformed or empty.
+ * 
+ * @throws If a `FirebaseApp` already exists with the same name but with a different configuration.
  * @public
  */
 export function initializeApp(
@@ -224,7 +231,12 @@ export function initializeApp(
  * @param config - Optional `FirebaseServerApp` settings.
  *
  * @returns The initialized `FirebaseServerApp`.
- *
+ * 
+ * @throws If invoked in an unsupported non-server environment such as a browser.
+ * 
+ * @throws If {@link FirebaseServerAppSettings.releaseOnDeref} is defined but the runtime doesn't
+ *   provide Finalization Registry support.
+ * 
  * @public
  */
 export function initializeServerApp(
@@ -238,7 +250,13 @@ export function initializeServerApp(
  * @param config - Optional `FirebaseServerApp` settings.
  *
  * @returns The initialized `FirebaseServerApp`.
- *
+ * 
+ * @throws If invoked in an unsupported non-server environment such as a browser.
+ * @throws If {@link FirebaseServerAppSettings.releaseOnDeref} is defined but the runtime doesn't
+ *   provide Finalization Registry support.
+ * @throws If the `FIREBASE_OPTIONS` enviornment variable does not contain a valid project
+ *   configuration required for auto-initialization.
+ * 
  * @public
  */
 export function initializeServerApp(