docs: clarify the definition of the bundle bundget defaults with strict mode (#42289)
Previously we didn't clarify that the stricter defaults have no impact on existing projects, and we also didn't define the default values for bundle budgets. Fixes #41966 PR Close #42289
This commit is contained in:
parent
1955dbb048
commit
dc6bff10ac
@ -215,10 +215,10 @@ Each budget entry is a JSON object with the following properties:
|
|||||||
The type of budget. One of:
|
The type of budget. One of:
|
||||||
|
|
||||||
* `bundle` - The size of a specific bundle.
|
* `bundle` - The size of a specific bundle.
|
||||||
* `initial` - The initial size of the app.
|
* `initial` - The size of JavaScript needed for bootstrapping the application. Defaults to warning @ 500kb and erroring at 1mb.
|
||||||
* `allScript` - The size of all scripts.
|
* `allScript` - The size of all scripts.
|
||||||
* `all` - The size of the entire app.
|
* `all` - The size of the entire app.
|
||||||
* `anyComponentStyle` - This size of any one component stylesheet.
|
* `anyComponentStyle` - This size of any one component stylesheet. Defaults to warning at 2kb and erroring at 4kb.
|
||||||
* `anyScript` - The size of any one script.
|
* `anyScript` - The size of any one script.
|
||||||
* `any` - The size of any file.
|
* `any` - The size of any file.
|
||||||
|
|
||||||
|
@ -5,11 +5,11 @@ Angular CLI creates all new workspaces and projects with **strict mode** enabled
|
|||||||
Strict mode improves maintainability and helps you catch bugs ahead of time.
|
Strict mode improves maintainability and helps you catch bugs ahead of time.
|
||||||
Additionally, strict mode applications are easier to statically analyze and can help the `ng update` command refactor code more safely and precisely when you are updating to future versions of Angular.
|
Additionally, strict mode applications are easier to statically analyze and can help the `ng update` command refactor code more safely and precisely when you are updating to future versions of Angular.
|
||||||
|
|
||||||
Specifically, strict mode does the following:
|
Specifically, strict mode affects newly generated applications in the following way:
|
||||||
|
|
||||||
* Enables [`strict` mode in TypeScript](https://www.typescriptlang.org/tsconfig#strict), as well as other strictness flags recommended by the TypeScript team. Specifically, `forceConsistentCasingInFileNames`, `noImplicitReturns`, `noFallthroughCasesInSwitch`.
|
* Enables [`strict` mode in TypeScript](https://www.typescriptlang.org/tsconfig#strict), as well as other strictness flags recommended by the TypeScript team. Specifically, `forceConsistentCasingInFileNames`, `noImplicitReturns`, `noFallthroughCasesInSwitch`.
|
||||||
* Turns on strict Angular compiler flags [`strictTemplates`](guide/angular-compiler-options#stricttemplates), [`strictInjectionParameters`](guide/angular-compiler-options#strictinjectionparameters) and [`strictInputAccessModifiers`](guide/template-typecheck#troubleshooting-template-errors).
|
* Turns on strict Angular compiler flags [`strictTemplates`](guide/angular-compiler-options#stricttemplates), [`strictInjectionParameters`](guide/angular-compiler-options#strictinjectionparameters) and [`strictInputAccessModifiers`](guide/template-typecheck#troubleshooting-template-errors).
|
||||||
* [Bundle size budgets](guide/build#configuring-size-budgets) have been reduced by ~75%.
|
* Reduces the [bundle size budgets](guide/build#configuring-size-budgets) for the `initial` and `anyComponentStyle` budget types by 75% compared to the previous defaults.
|
||||||
|
|
||||||
You can apply these settings at the workspace and project level.
|
You can apply these settings at the workspace and project level.
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user