{"record":{"id":"b9e75da997e93c60","repo":"angular/angular-cli","slug":"the-commonchunk-option-is-always-enabled-by-this","errorCode":null,"errorMessage":"The 'commonChunk' option is always enabled by this builder and will be ignored.","messagePattern":"The 'commonChunk' option is always enabled by this builder and will be ignored\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"packages/angular_devkit/build_angular/src/builders/browser-esbuild/index.ts","lineNumber":45,"sourceCode":"  context: BuilderContext,\n  infrastructureSettings?: {\n    write?: boolean;\n  },\n  plugins?: Plugin[],\n): AsyncIterable<BuilderOutput> {\n  context.logger.warn(\n    'The \"@angular-devkit/build-angular:browser-esbuild\" builder is deprecated as part of Angular\\'s Webpack support deprecation. ' +\n      'Use \"@angular/build:application\" instead. For more information, see https://angular.dev/tools/cli/build-system-migration.',\n  );\n\n  // Warn about any unsupported options\n  if (userOptions['vendorChunk']) {\n    context.logger.warn(\n      `The 'vendorChunk' option is not used by this builder and will be ignored.`,\n    );\n  }\n  if (userOptions['commonChunk'] === false) {\n    context.logger.warn(\n      `The 'commonChunk' option is always enabled by this builder and will be ignored.`,\n    );\n  }\n  if (userOptions['webWorkerTsConfig']) {\n    context.logger.warn(`The 'webWorkerTsConfig' option is not yet supported by this builder.`);\n  }\n\n  // Convert browser builder options to application builder options\n  const normalizedOptions = convertBrowserOptions(userOptions);\n\n  // Execute the application builder\n  yield* buildApplication(normalizedOptions, context, { codePlugins: plugins });\n}\n\nexport function convertBrowserOptions(\n  options: BrowserBuilderOptions,\n): Omit<ApplicationBuilderOptions, 'outputPath'> & { outputPath: OutputPathClass } {\n  const {","sourceCodeStart":27,"sourceCodeEnd":63,"githubUrl":"https://github.com/angular/angular-cli/blob/bb72145f9ab45aee29f523236b3a25cd0813a841/packages/angular_devkit/build_angular/src/builders/browser-esbuild/index.ts#L27-L63","documentation":"Warning issued by the browser-esbuild builder when 'commonChunk' is explicitly set to false. In the esbuild builder, extracting a common chunk is always enabled, so a request to disable it cannot be honored and is ignored. The build completes but chunking behaves as if commonChunk were enabled.","triggerScenarios":"Running '@angular-devkit/build-angular:browser-esbuild' with `commonChunk: false` in the target options (typically migrated from the Webpack 'browser' builder where the option was supported).","commonSituations":"Projects that disabled the common chunk in Webpack to change lazy-loading granularity, then switched the builder to browser-esbuild without cleaning options.","solutions":["Remove `\"commonChunk\": false` from the browser-esbuild target options.","If you truly need commonChunk disabled, stay on (or return to) the Webpack '@angular-devkit/build-angular:browser' builder.","Migrate to '@angular/build:application' and accept automatic chunk splitting."],"exampleFix":"// before\n\"options\": { \"commonChunk\": false }\n// after\n\"options\": {}","handlingStrategy":"validation","validationCode":"if (builder === '@angular-devkit/build-angular:browser-esbuild' && target.options?.commonChunk === false) {\n  delete target.options.commonChunk; // always enabled by this builder\n}","typeGuard":"function disablesCommonChunk(o: unknown): o is { commonChunk: false } {\n  return typeof o === 'object' && o !== null && (o as any).commonChunk === false;\n}","tryCatchPattern":null,"preventionTips":["Remove Webpack-only chunking options when switching builders.","Validate options against the '@angular/build' JSON schema in CI.","Document builder-specific option differences for the team."],"tags":["angular-cli","deprecation","build-options","esbuild"],"backgroundTag":"unsupported-builder-option","analyzedSha":"bb72145f9ab45aee29f523236b3a25cd0813a841","analyzedAt":"2026-08-30T02:47:34.745Z","schemaVersion":2},"datasetVersion":"2026-08-30T03:17:51.788Z"}