Skip to content

Commit 73f44fb

Browse files
ricardochlricardochl
committed
translate: translations for version compatibility guide
Fixesx #147
1 parent e213692 commit 73f44fb

2 files changed

Lines changed: 221 additions & 56 deletions

File tree

‎adev-es/src/content/reference/versions.en.md‎

Lines changed: 165 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,165 @@
1+
# Version compatibility
2+
3+
The following tables describe the versions of Node.js, TypeScript, and RxJS that each version of
4+
Angular requires.
5+
6+
## Actively supported versions
7+
8+
This table covers [Angular versions under active support](reference/releases#actively-supported-versions).
9+
10+
| Angular | Node.js | TypeScript | RxJS |
11+
| ------------------ | ----------------------------------- | -------------- | ------------------ |
12+
| 21.0.x | ^20.19.0 \|\| ^22.12.0 \|\| ^24.0.0 | >=5.9.0 <6.0.0 | ^6.5.3 \|\| ^7.4.0 |
13+
| 20.2.x \|\| 20.3.x | ^20.19.0 \|\| ^22.12.0 \|\| ^24.0.0 | >=5.8.0 <6.0.0 | ^6.5.3 \|\| ^7.4.0 |
14+
| 20.0.x \|\| 20.1.x | ^20.19.0 \|\| ^22.12.0 \|\| ^24.0.0 | >=5.8.0 <5.9.0 | ^6.5.3 \|\| ^7.4.0 |
15+
| 19.2.x | ^18.19.1 \|\| ^20.11.1 \|\| ^22.0.0 | >=5.5.0 <5.9.0 | ^6.5.3 \|\| ^7.4.0 |
16+
| 19.1.x | ^18.19.1 \|\| ^20.11.1 \|\| ^22.0.0 | >=5.5.0 <5.8.0 | ^6.5.3 \|\| ^7.4.0 |
17+
| 19.0.x | ^18.19.1 \|\| ^20.11.1 \|\| ^22.0.0 | >=5.5.0 <5.7.0 | ^6.5.3 \|\| ^7.4.0 |
18+
19+
## Unsupported Angular versions
20+
21+
This table covers Angular versions that are no longer under long-term support (LTS). This
22+
information was correct when each version went out of LTS and is provided without any further
23+
guarantees. It is listed here for historical reference.
24+
25+
| Angular | Node.js | TypeScript | RxJS |
26+
| ------------------ | ------------------------------------ | -------------- | ------------------ |
27+
| 18.1.x \|\| 18.2.x | ^18.19.1 \|\| ^20.11.1 \|\| ^22.0.0 | >=5.4.0 <5.6.0 | ^6.5.3 \|\| ^7.4.0 |
28+
| 18.0.x | ^18.19.1 \|\| ^20.11.1 \|\| ^22.0.0 | >=5.4.0 <5.5.0 | ^6.5.3 \|\| ^7.4.0 |
29+
| 17.3.x | ^18.13.0 \|\| ^20.9.0 | >=5.2.0 <5.5.0 | ^6.5.3 \|\| ^7.4.0 |
30+
| 17.1.x \|\| 17.2.x | ^18.13.0 \|\| ^20.9.0 | >=5.2.0 <5.4.0 | ^6.5.3 \|\| ^7.4.0 |
31+
| 17.0.x | ^18.13.0 \|\| ^20.9.0 | >=5.2.0 <5.3.0 | ^6.5.3 \|\| ^7.4.0 |
32+
| 16.1.x \|\| 16.2.x | ^16.14.0 \|\| ^18.10.0 | >=4.9.3 <5.2.0 | ^6.5.3 \|\| ^7.4.0 |
33+
| 16.0.x | ^16.14.0 \|\| ^18.10.0 | >=4.9.3 <5.1.0 | ^6.5.3 \|\| ^7.4.0 |
34+
| 15.1.x \|\| 15.2.x | ^14.20.0 \|\| ^16.13.0 \|\| ^18.10.0 | >=4.8.2 <5.0.0 | ^6.5.3 \|\| ^7.4.0 |
35+
| 15.0.x | ^14.20.0 \|\| ^16.13.0 \|\| ^18.10.0 | ~4.8.2 | ^6.5.3 \|\| ^7.4.0 |
36+
| 14.2.x \|\| 14.3.x | ^14.15.0 \|\| ^16.10.0 | >=4.6.2 <4.9.0 | ^6.5.3 \|\| ^7.4.0 |
37+
| 14.0.x \|\| 14.1.x | ^14.15.0 \|\| ^16.10.0 | >=4.6.2 <4.8.0 | ^6.5.3 \|\| ^7.4.0 |
38+
| 13.3.x \|\| 13.4.x | ^12.20.0 \|\| ^14.15.0 \|\| ^16.10.0 | >=4.4.3 <4.7.0 | ^6.5.3 \|\| ^7.4.0 |
39+
| 13.1.x \|\| 13.2.x | ^12.20.0 \|\| ^14.15.0 \|\| ^16.10.0 | >=4.4.3 <4.6.0 | ^6.5.3 \|\| ^7.4.0 |
40+
| 13.0.x | ^12.20.0 \|\| ^14.15.0 \|\| ^16.10.0 | ~4.4.3 | ^6.5.3 \|\| ^7.4.0 |
41+
| 12.2.x | ^12.14.0 \|\| ^14.15.0 | >=4.2.3 <4.4.0 | ^6.5.3 \|\| ^7.0.0 |
42+
| 12.1.x | ^12.14.0 \|\| ^14.15.0 | >=4.2.3 <4.4.0 | ^6.5.3 |
43+
| 12.0.x | ^12.14.0 \|\| ^14.15.0 | ~4.2.3 | ^6.5.3 |
44+
| 11.2.x | ^10.13.0 \|\| ^12.11.0 | >=4.0.0 <4.2.0 | ^6.5.3 |
45+
| 11.1.x | ^10.13.0 \|\| ^12.11.0 | >=4.0.0 <4.2.0 | ^6.5.3 |
46+
| 11.0.x | ^10.13.0 \|\| ^12.11.0 | ~4.0.0 | ^6.5.3 |
47+
| 10.2.x | ^10.13.0 \|\| ^12.11.0 | >=3.9.0 <4.1.0 | ^6.5.3 |
48+
| 10.1.x | ^10.13.0 \|\| ^12.11.0 | >=3.9.0 <4.1.0 | ^6.5.3 |
49+
| 10.0.x | ^10.13.0 \|\| ^12.11.0 | ~3.9.0 | ^6.5.3 |
50+
| 9.1.x | ^10.13.0 \|\| ^12.11.0 | >=3.6.0 <3.9.0 | ^6.5.3 |
51+
| 9.0.x | ^10.13.0 \|\| ^12.11.0 | >=3.6.0 <3.8.0 | ^6.5.3 |
52+
53+
### Before v9
54+
55+
Until Angular v9, Angular and Angular CLI versions were not synced.
56+
57+
| Angular | Angular CLI | Node.js | TypeScript | RxJS |
58+
| --------------------------- | --------------------------- | ------------------- | -------------- | ------ |
59+
| 8.2.x | 8.2.x \|\| 8.3.x | ^10.9.0 | >=3.4.2 <3.6.0 | ^6.4.0 |
60+
| 8.0.x \|\| 8.1.x | 8.0.x \|\| 8.1.x | ^10.9.0 | ~3.4.2 | ^6.4.0 |
61+
| 7.2.x | 7.2.x \|\| 7.3.x | ^8.9.0 \|\| ^10.9.0 | >=3.1.3 <3.3.0 | ^6.0.0 |
62+
| 7.0.x \|\| 7.1.x | 7.0.x \|\| 7.1.x | ^8.9.0 \|\| ^10.9.0 | ~3.1.3 | ^6.0.0 |
63+
| 6.1.x | 6.1.x \|\| 6.2.x | ^8.9.0 | >=2.7.2 <3.0.0 | ^6.0.0 |
64+
| 6.0.x | 6.0.x | ^8.9.0 | ~2.7.2 | ^6.0.0 |
65+
| 5.2.x | 1.6.x \|\| 1.7.x | ^6.9.0 \|\| ^8.9.0 | >=2.4.2 <2.7.0 | ^5.5.0 |
66+
| 5.0.x \|\| 5.1.x | 1.5.x | ^6.9.0 \|\| ^8.9.0 | ~2.4.2 | ^5.5.0 |
67+
| 4.2.x \|\| 4.3.x \|\| 4.4.x | 1.4.x | ^6.9.0 \|\| ^8.9.0 | >=2.1.6 <2.5.0 | ^5.0.1 |
68+
| 4.2.x \|\| 4.3.x \|\| 4.4.x | 1.3.x | ^6.9.0 | >=2.1.6 <2.5.0 | ^5.0.1 |
69+
| 4.0.x \|\| 4.1.x | 1.0.x \|\| 1.1.x \|\| 1.2.x | ^6.9.0 | >=2.1.6 <2.4.0 | ^5.0.1 |
70+
| 2.x | - | ^6.9.0 | >=1.8.0 <2.2.0 | ^5.0.1 |
71+
72+
## Browser support
73+
74+
Angular uses the ["widely available" Baseline](https://web.dev/baseline) to define browser
75+
support. For each major version, Angular supports browsers included in the Baseline of a
76+
chosen date near the release date for that major.
77+
78+
The "widely available" Baseline includes browsers released less than 30 months (2.5 years)
79+
of the chosen date within Baseline's core browser set (Chrome, Edge, Firefox, Safari) and
80+
targets supporting approximately 95% of web users.
81+
82+
| Angular | Baseline Date | Browser Set |
83+
| ------- | ------------- | --------------------------- |
84+
| v21 | 2025-10-20 | [Browser Set][browsers-v21] |
85+
| v20 | 2025-04-30 | [Browser Set][browsers-v20] |
86+
87+
[browsers-v21]: https://web-platform-dx.github.io/web-features/supported-browsers/?widelyAvailableOnDate=2025-10-20&includeDownstream=false
88+
[browsers-v20]: https://web-platform-dx.github.io/web-features/supported-browsers/?widelyAvailableOnDate=2025-04-30&includeDownstream=false
89+
90+
Angular versions prior to v20 support the following specific browser versions:
91+
92+
| Browser | Supported versions |
93+
| :------ | :------------------------------------------ |
94+
| Chrome | 2 most recent versions |
95+
| Firefox | latest and extended support release \(ESR\) |
96+
| Edge | 2 most recent major versions |
97+
| Safari | 2 most recent major versions |
98+
| iOS | 2 most recent major versions |
99+
| Android | 2 most recent major versions |
100+
101+
## Polyfills
102+
103+
Angular is built on the latest standards of the web platform.
104+
Targeting such a wide range of browsers is challenging because they do not support all features of modern browsers.
105+
You compensate by loading polyfill scripts \("polyfills"\) for the browsers that you must support.
106+
See instructions on how to include polyfills into your project below.
107+
108+
IMPORTANT: The suggested polyfills are the ones that run full Angular applications.
109+
You might need additional polyfills to support features not covered by this list.
110+
111+
HELPFUL: Polyfills cannot magically transform an old, slow browser into a modern, fast one.
112+
113+
## Enabling polyfills with CLI projects
114+
115+
The [Angular CLI](tools/cli) provides support for polyfills.
116+
If you are not using the CLI to create your projects, see [Polyfill instructions for non-CLI users](#polyfills-for-non-cli-users).
117+
118+
The `polyfills` options of the [browser and test builder](tools/cli/cli-builder) can be a full path for a file \(Example: `src/polyfills.ts`\) or,
119+
relative to the current workspace or module specifier \(Example: `zone.js`\).
120+
121+
If you create a TypeScript file, make sure to include it in the `files` property of your `tsconfig` file.
122+
123+
```json
124+
125+
{
126+
"extends": "./tsconfig.json",
127+
"compilerOptions": {
128+
...
129+
},
130+
"files": [
131+
"src/main.ts",
132+
"src/polyfills.ts"
133+
]
134+
...
135+
}
136+
```
137+
138+
## Polyfills for non-CLI users
139+
140+
If you are not using the CLI, add your polyfill scripts directly to the host web page \(`index.html`\).
141+
142+
For example:
143+
144+
<docs-code header="src/index.html" language="html">
145+
<!-- pre-zone polyfills -->
146+
<script src="node_modules/core-js/client/shim.min.js"></script>
147+
<script>
148+
/**
149+
* you can configure some zone flags which can disable zone interception for some
150+
* asynchronous activities to improve startup performance - use these options only
151+
* if you know what you are doing as it could result in hard to trace down bugs.
152+
*/
153+
// __Zone_disable_requestAnimationFrame = true; // disable patch requestAnimationFrame
154+
// __Zone_disable_on_property = true; // disable patch onProperty such as onclick
155+
// __zone_symbol__UNPATCHED_EVENTS = ['scroll', 'mousemove']; // disable patch specified eventNames
156+
/*
157+
* in Edge developer tools, the addEventListener will also be wrapped by zone.js
158+
* with the following flag, it will bypass `zone.js` patch for Edge.
159+
*/
160+
// __Zone_enable_cross_context_check = true;
161+
</script>
162+
<!-- zone.js required by Angular -->
163+
<script src="node_modules/zone.js/bundles/zone.umd.js"></script>
164+
<!-- application polyfills -->
165+
</docs-code>

0 commit comments

Comments
 (0)