{"record":{"id":"85856c0896115498","repo":"angular/angular-cli","slug":"the-vendorchunk-option-is-not-used-by-this-build","errorCode":null,"errorMessage":"The 'vendorChunk' option is not used by this builder and will be ignored.","messagePattern":"The 'vendorChunk' option is not used 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":40,"sourceCode":" * @param context The Architect builder context object\n * @returns An async iterable with the builder result output\n */\nexport async function* buildEsbuildBrowser(\n  userOptions: BrowserBuilderOptions,\n  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}","sourceCodeStart":22,"sourceCodeEnd":58,"githubUrl":"https://github.com/angular/angular-cli/blob/bb72145f9ab45aee29f523236b3a25cd0813a841/packages/angular_devkit/build_angular/src/builders/browser-esbuild/index.ts#L22-L58","documentation":"This is a warning emitted by the deprecated esbuild-based browser builder when the 'vendorChunk' option is present in the user's configuration. The esbuild builder splits chunks differently than the legacy Webpack builder and has no concept of a separate vendor chunk, so the option is silently ignored rather than applied. The build still proceeds normally.","triggerScenarios":"Running the '@angular-devkit/build-angular:browser-esbuild' builder with `vendorChunk: true` (or any truthy value) in angular.json, project.json, or the ng build command line.","commonSituations":"Teams migrating from the Webpack 'browser' builder to 'browser-esbuild' (or switching between builders) while keeping the same options schema; shared angular.json used for both builders; copying Webpack-era build options into new targets.","solutions":["Remove the 'vendorChunk' option from the browser-esbuild target configuration in angular.json.","If a vendor chunk is required, migrate to the '@angular/build:application' builder and adjust chunking strategy accordingly (chunking is automatic).","Move the option to a separate Webpack-based builder target if you still need Webpack behavior."],"exampleFix":"// angular.json before\n\"builder\": \"@angular-devkit/build-angular:browser-esbuild\",\n\"options\": { \"vendorChunk\": true, \"outputPath\": \"dist/app\" }\n// after\n\"builder\": \"@angular-devkit/build-angular:browser-esbuild\",\n\"options\": { \"outputPath\": \"dist/app\" }","handlingStrategy":"validation","validationCode":"const esbuildOptions = new Set(['outputPath','index','main','browser','polyfills','tsConfig','assets','styles','scripts','...']);\nif (target.options && 'vendorChunk' in target.options && target.builder.includes('browser-esbuild')) {\n  console.warn('vendorChunk is ignored by browser-esbuild; remove it.');\n}","typeGuard":"function hasVendorChunk(o: object): o is { vendorChunk: unknown } {\n  return 'vendorChunk' in o;\n}","tryCatchPattern":null,"preventionTips":["Keep option sets per builder; do not share angular.json options blocks across Webpack and esbuild builders.","Treat builder deprecation warnings in CI logs as migration TODOs.","Lint angular.json with a schema check for the active builder."],"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"}