History

Alan Agius 13ba84731f build: prepare for TypeScript 3.9 (#36989 ) - Fix several compilation errors - Update @microsoft/api-extractor to be compatible with TypeScript 3.9 PR Close #36989		2020-05-14 10:50:28 -07:00
..
dist	build(zone.js): sets rollup_bundle to use the --silent flag (#35835 )	2020-03-03 13:53:52 -08:00
doc	…
example	build: reformat repo to new clang@1.4.0 (#36613 )	2020-04-14 12:08:36 -07:00
lib	build: prepare for TypeScript 3.9 (#36989 )	2020-05-14 10:50:28 -07:00
scripts	…
test	revert: "feat(dev-infra): exposed new rule 'component_benchmark' via dev_infra (#36434 )" (#36798 )	2020-04-24 11:03:38 -07:00
BUILD.bazel	build: add npm_integration_test && angular_integration_test (#33927 )	2020-02-24 08:59:18 -08:00
CHANGELOG.md	release: cut the zone.js-0.10.3 release (#34508 )	2020-03-16 15:49:07 -07:00
DEVELOPER.md	build(zone.js): Update `zone.js` release process to use `google-wombot` (#36110 )	2020-03-17 10:40:32 -07:00
MODULE.md	feat(zone.js): Monkey patch MessagePort.prototype onproperties (#34610 )	2020-03-16 08:59:38 -07:00
NON-STANDARD-APIS.md	docs: update zone-bluebird patch document for angular (#34536 )	2020-02-03 14:05:22 -08:00
README.md	fix(zone.js): update dart zone link (#31646 )	2019-07-23 21:12:52 -07:00
SAMPLE.md	…
STANDARD-APIS.md	…
bundles.bzl	feat(zone.js): Monkey patch MessagePort.prototype onproperties (#34610 )	2020-03-16 08:59:38 -07:00
check-file-size.js	build: reformat repo to new clang@1.4.0 (#36613 )	2020-04-14 12:08:36 -07:00
file-size-limit.json	…
karma-base.conf.js	…
karma-build-jasmine.conf.js	…
karma-build-jasmine.es2015.conf.js	…
karma-build-mocha.conf.js	…
karma-build-sauce-mocha.conf.js	…
karma-build-sauce-selenium3-mocha.conf.js	…
karma-build.conf.js	…
karma-dist-jasmine.conf.js	…
karma-dist-mocha.conf.js	…
karma-dist-sauce-jasmine.conf.js	…
karma-dist-sauce-jasmine.es2015.conf.js	…
karma-dist-sauce-jasmine3.conf.js	…
karma-dist-sauce-selenium3-jasmine.conf.js	…
karma-dist.conf.js	…
karma-evergreen-dist-jasmine.conf.js	…
karma-evergreen-dist-sauce-jasmine.conf.js	…
karma-evergreen-dist.conf.js	…
package.json	build(zone.js): Update `zone.js` release process to use `google-wombot` (#36110 )	2020-03-17 10:40:32 -07:00
presentation.png	…
rollup-es5.config.js	fix(zone.js): fix `zone-patch-rxjs` bundle to refer to `rxjs` (rather than include) it. (#35983 )	2020-03-11 15:09:03 -07:00
rollup-es5_global-es2015.config.js	build: bump year (#34651 )	2020-01-13 07:21:43 -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	build: reformat repo to new clang@1.4.0 (#36613 )	2020-04-14 12:08:36 -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: reformat repo to new clang@1.4.0 (#36613 )	2020-04-14 12:08:36 -07:00
tsconfig.json	build: remove vendored Babel typings (#33226 )	2019-10-17 18:45:52 -04:00

README.md

Zone.js

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.

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:

See also

async-listener - a similar library for node
Async stack traces in Chrome
strongloop/zone (Deprecated)
vizone - control flow visualizer that uses zone.js

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

There are several bundles under dist folder.

Bundle	Summary
zone.js	the default bundle, contains the most used APIs such as `setTimeout/Promise/EventTarget...`, also this bundle supports all evergreen and legacy (IE/Legacy Firefox/Legacy Safari) Browsers
zone-evergreen.js	the bundle for evergreen browsers, doesn't include the `patch` for `legacy` browsers such as `IE` or old versions of `Firefox/Safari`
zone-legacy.js	the patch bundle for legacy browsers, only includes the `patch` for `legacy` browsers such as `IE` or old versions of `Firefox/Safari`. This bundle must be loaded after `zone-evergreen.js`, `zone.js`=`zone-evergreen.js` + `zone-legacy.js`
zone-testing.js	the bundle for zone testing support, including `jasmine/mocha` support and `async/fakeAsync/sync` test utilities
zone-externs.js	the API definitions for `closure compiler`

And here are the additional optional patches not included in the main zone.js bundles

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 remove `Zone StackTrace`
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	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`

Promise A+ test passed

License

MIT