angular-cn/packages/zone.js
Renovate Bot 670300e9ab build: lock file maintenance (#42824)
PR Close #42824
2021-07-15 13:22:37 -07:00
..
bundles feat(zone.js): upgrade zone.js to angular package format(APF) (#36540) 2020-06-11 11:08:48 -07:00
dist fix(zone.js): should have better backward compatibilities (#38797) 2020-09-17 09:32:19 -07:00
doc
example build: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04:00
fesm2015 feat(zone.js): upgrade zone.js to angular package format(APF) (#36540) 2020-06-11 11:08:48 -07:00
lib fix(zone.js): only one listener should also re-throw an error correctly (#41868) 2021-06-10 09:24:03 -07:00
mix feat(zone.js): upgrade zone.js to angular package format(APF) (#36540) 2020-06-11 11:08:48 -07:00
node feat(zone.js): upgrade zone.js to angular package format(APF) (#36540) 2020-06-11 11:08:48 -07:00
plugins feat(zone.js): move all zone optional bundles to plugins folders (#36540) 2020-06-11 11:08:48 -07:00
scripts test(zone.js): add zone.js externs test (#39108) 2020-10-22 13:40:08 -07:00
test refactor(zone.js): ensure compatibility with noImplicitOverride (#42512) 2021-07-12 13:11:16 -07:00
testing feat(zone.js): upgrade zone.js to angular package format(APF) (#36540) 2020-06-11 11:08:48 -07:00
.gitignore test(zone.js): add zone.js externs test (#39108) 2020-10-22 13:40:08 -07:00
BUILD.bazel refactor(zone.js): refactor zone rollup config (#40481) 2021-01-25 10:43:39 -08:00
CHANGELOG.md release: cut the zone.js-0.11.4 release (#40775) 2021-02-12 13:33:05 -08:00
DEVELOPER.md docs(zone.js): update release doc (#39442) 2020-10-28 10:59:47 -07:00
MODULE.md feat(core): drop support for zone.js 0.10.x (#40823) 2021-02-24 07:58:29 -08:00
NON-STANDARD-APIS.md feat(core): drop support for zone.js 0.10.x (#40823) 2021-02-24 07:58:29 -08:00
README.md docs: update links to use HTTPS as protocol (#39718) 2020-11-20 12:52:16 -08:00
SAMPLE.md
STANDARD-APIS.md refactor(zone.js): remove usages of blacklist related to UNPATCHED_EVENTS (#38930) 2020-09-22 15:05:01 -07:00
bundles.bzl refactor(zone.js): refactor zone rollup config (#40481) 2021-01-25 10:43:39 -08:00
check-file-size.js build: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04:00
file-size-limit.json
karma-base.conf.js build: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04:00
karma-build-jasmine.conf.js
karma-build-jasmine.es2015.conf.js
karma-build-mocha.conf.js
karma-build-sauce-mocha.conf.js build: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04:00
karma-build-sauce-selenium3-mocha.conf.js test(zone.js): do not run tests on IE 9 and IE 10 (#39189) 2020-10-12 08:27:25 -07:00
karma-build.conf.js build: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04:00
karma-dist-jasmine.conf.js
karma-dist-mocha.conf.js
karma-dist-sauce-jasmine.conf.js build: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04:00
karma-dist-sauce-jasmine.es2015.conf.js
karma-dist-sauce-jasmine3.conf.js test(zone.js): do not run tests on IE 9 and IE 10 (#39189) 2020-10-12 08:27:25 -07:00
karma-dist-sauce-selenium3-jasmine.conf.js build: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04:00
karma-dist.conf.js build: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04:00
karma-evergreen-dist-jasmine.conf.js
karma-evergreen-dist-sauce-jasmine.conf.js build: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04:00
karma-evergreen-dist.conf.js build: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04:00
package.json build: update to typescript 4.3.4 (#42600) 2021-06-21 16:42:49 +00:00
presentation.png
rollup.config.js docs: update year (#40925) 2021-02-22 12:37:40 -08:00
sauce-evergreen.conf.js build: reformat repo to new clang@1.4.0 (#36613) 2020-04-14 12:08:36 -07:00
sauce-selenium3.conf.js
sauce.conf.js test(zone.js): do not run tests on IE 9 and IE 10 (#39189) 2020-10-12 08:27:25 -07:00
sauce.es2015.conf.js build: reformat repo to new clang@1.4.0 (#36613) 2020-04-14 12:08:36 -07:00
simple-server.js build: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04:00
tools.bzl refactor(zone.js): refactor zone rollup config (#40481) 2021-01-25 10:43:39 -08:00
tsconfig.json build: enable noImplicitOverride in project (#42512) 2021-07-12 13:11:14 -07:00
yarn.lock build: lock file maintenance (#42824) 2021-07-15 13:22:37 -07:00

README.md

Zone.js

CDNJS

Implements Zones for JavaScript, inspired by Dart.

If you're using zone.js via unpkg (i.e. using https://unpkg.com/zone.js) and you're using any of the following libraries, make sure you import them first

  • 'newrelic' as it patches global.Promise before zone.js does
  • 'async-listener' as it patches global.setTimeout, global.setInterval before zone.js does
  • 'continuation-local-storage' as it uses async-listener

NEW Zone.js POST-v0.6.0

See the new API here.

Read up on Zone Primer.

BREAKING CHANGES since Zone.js v0.11.1

Prior to v0.11.1, Zone.js provided two distribution bundle formats in the dist folder. They were (1) ES5 bundle distributed as zone.js and (2) ES2015 bundle distributed as zone-evergreen.js. Both of these bundles were in UMD format, and are used for Angular's differential-loading mechanism.

Starting with v0.11.1, Zone.js follows the Angular Package Format. Therefor the new Zone.js file layout is:

  • bundles: ES5 bundle in UMD format.
  • fesm2015: ES5 bundle in ESM format.
  • dist: ES5 bundle in UMD format. This directory is present to keep backward compatibility.

If you are using Angular CLI, the polyfills.ts file will contain:

import 'zone.js/dist/zone';

Starting with Zone.js v0.11.1+ the import changes to:

import 'zone.js';

Prior to v0.11.1 the import would load the ES5 bundle in UMD format from dist/zone.js. Starting with v0.11.1 the import loads the ES2015 bundle in ESM format instead.

This is a breaking change for legacy browsers such as IE11.

For backwards compatibility zone.js continues to distribute the same bundles under dist. To restore the old behavior import from the dist directory instead like so:

import 'zone.js/dist/zone';

For details, please refer the changelog and the PR.

What's a Zone?

A Zone is an execution context that persists across async tasks. You can think of it as thread-local storage for JavaScript VMs.

See this video from ng-conf 2014 for a detailed explanation:

screenshot of the zone.js presentation and ng-conf 2014

See also

Standard API support

zone.js patched most standard web APIs (such as DOM events, XMLHttpRequest, ...) and nodejs APIs (EventEmitter, fs, ...), for more details, please see STANDARD-APIS.md.

Nonstandard API support

We are adding support to some nonstandard APIs, such as MediaQuery and Notification. Please see NON-STANDARD-APIS.md for more details.

Examples

You can find some samples to describe how to use zone.js in SAMPLE.md.

Modules

zone.js patches the async APIs described above, but those patches will have some overhead. Starting from zone.js v0.8.9, you can choose which web API module you want to patch. For more details, please see MODULE.md.

Bundles

Starting with v0.11.0, zone.js uses Angular Package Format for bundle distribution. (For backwards compatibility, all bundles can still be accessed from dist folder.)

Bundle Summary
zone.js The default bundle. Contains the most used APIs such as setTimeout/Promise/EventTarget..., it also supports differential loading by importing this bundle using import zone.js. In legacy browsers it includes some additional patches such as registerElement and EventTarget like APIs.
zone-testing.js The bundle for zone testing support of jasmine / mocha / jest. Also includes test utility functions async / fakeAsync / sync.
zone-node.js The NodeJS support bundle.
zone-mix.js A mixed bundle which supports both browser and NodeJS. Useful for mixed environment such as Electron.
zone-externs.js the API definitions for closure compiler.

Additional optional patches not included in the zone.js bundles which extend functionality. The additional bundles can be found under zone.js/plugins folder. To use these bundles, add the following code after importing zone.js bundle.

import 'zone.js';
// For example, import canvas patch
import 'zone.js/plugins/zone-patch-canvas';
Patch Summary
webapis-media-query.js patch for MediaQuery APIs
webapis-notification.js patch for Notification APIs
webapis-rtc-peer-connection.js patch for RTCPeerConnection APIs
webapis-shadydom.js patch for Shady DOM APIs
zone-bluebird.js patch for Bluebird APIs
zone-error.js patch for Error Global Object, supports adding zone information to stack frame, and also removing unrelated stack frames from zone.js internally
zone-patch-canvas.js patch for Canvas API
zone-patch-cordova.js patch for Cordova API
zone-patch-electron.js patch for Electron API
zone-patch-fetch.js patch for Fetch API
zone-patch-jsonp.js helper utility for jsonp API
zone-patch-resize-observer.js patch for ResizeObserver API
zone-patch-rxjs.js patch for rxjs API
zone-patch-rxjs-fake-async.js patch for rxjs fakeasync test
zone-patch-socket-io.js patch for socket-io
zone-patch-user-media.js patch for UserMedia API
zone-patch-message-port.js patch for MessagePort API

Promise A+ test passed

Promises/A+ 1.1 compliant

License

MIT