feat(platform-browser): add context to createApplication

dgp1130 · AndrewKushnir · commit ec9dc94ceeb3 · 2025-11-10T14:18:29.000-08:00
This is necessary to use SSR safely with `createApplication` and avoid constraining users to `bootstrapApplication`. It is one more step towards feature parity between `createApplication` and `bootstrapApplication`.
diff --git a/goldens/public-api/platform-browser/index.api.md b/goldens/public-api/platform-browser/index.api.md
@@ -52,7 +52,7 @@ export class By {
 }
 
 // @public
-export function createApplication(options?: ApplicationConfig): Promise<ApplicationRef>;
+export function createApplication(options?: ApplicationConfig, context?: BootstrapContext): Promise<ApplicationRef>;
 
 // @public
 export function disableDebugTools(): void;
diff --git a/packages/platform-browser/src/browser.ts b/packages/platform-browser/src/browser.ts
@@ -131,8 +131,7 @@ export async function bootstrapApplication(
 ): Promise<ApplicationRef> {
   const config = {
     rootComponent,
-    platformRef: context?.platformRef,
-    ...createProvidersConfig(options),
+    ...createProvidersConfig(options, context),
   };
 
   if ((typeof ngJitMode === 'undefined' || ngJitMode) && typeof fetch === 'function') {
@@ -150,20 +149,27 @@ export async function bootstrapApplication(
  *
  * @param options Extra configuration for the application environment, see `ApplicationConfig` for
  *     additional info.
+ * @param context Optional context object that can be used to provide a pre-existing
+ *     platform injector. This is useful for advanced use-cases, for example, server-side
+ *     rendering, where the platform is created for each request.
  * @returns A promise that returns an `ApplicationRef` instance once resolved.
  *
  * @publicApi
  */
-export async function createApplication(options?: ApplicationConfig): Promise<ApplicationRef> {
+export async function createApplication(
+  options?: ApplicationConfig,
+  context?: BootstrapContext,
+): Promise<ApplicationRef> {
   if ((typeof ngJitMode === 'undefined' || ngJitMode) && typeof fetch === 'function') {
     await resolveJitResources();
   }
 
-  return internalCreateApplication(createProvidersConfig(options));
+  return internalCreateApplication(createProvidersConfig(options, context));
 }
 
-function createProvidersConfig(options?: ApplicationConfig) {
+function createProvidersConfig(options?: ApplicationConfig, context?: BootstrapContext) {
   return {
+    platformRef: context?.platformRef,
     appProviders: [...BROWSER_MODULE_PROVIDERS, ...(options?.providers ?? [])],
     platformProviders: INTERNAL_BROWSER_PLATFORM_PROVIDERS,
   };
diff --git a/packages/platform-server/test/integration_spec.ts b/packages/platform-server/test/integration_spec.ts
@@ -47,10 +47,12 @@ import {
   provideNgReflectAttributes,
   ɵSSR_CONTENT_INTEGRITY_MARKER as SSR_CONTENT_INTEGRITY_MARKER,
   provideZoneChangeDetection,
+  signal,
 } from '@angular/core';
 import {TestBed} from '@angular/core/testing';
 import {
   bootstrapApplication,
+  createApplication,
   BootstrapContext,
   BrowserModule,
   provideClientHydration,
@@ -767,6 +769,24 @@ class HiddenModule {}
         TestBed.resetTestingModule();
       });
 
+      it('should render with `createApplication`', async () => {
+        const output = await renderApplication(
+          async (context) => {
+            const appRef = await createApplication(
+              {
+                providers: [provideZoneChangeDetection()],
+              },
+              context,
+            );
+            appRef.bootstrap(createMyAsyncServerApp(true));
+            return appRef;
+          },
+          {document: doc},
+        );
+
+        expect(output).toBe(expectedOutput);
+      });
+
       it('using long form should work', async () => {
         const platform = platformServer([
           {

Original file line number	Diff line number	Diff line change
`@@ -52,7 +52,7 @@ export class By {`
`52`	`52`	`}`
`53`	`53`
`54`	`54`	`// @public`
`55`		`-export function createApplication(options?: ApplicationConfig): Promise<ApplicationRef>;`
	`55`	`+export function createApplication(options?: ApplicationConfig, context?: BootstrapContext): Promise<ApplicationRef>;`
`56`	`56`
`57`	`57`	`// @public`
`58`	`58`	`export function disableDebugTools(): void;`