angular-cn/packages/zone.js
Paul Gschwendtner 6d3a25d897 ci: run acceptance tests on saucelabs with ivy (#34277)
Currently we only run Saucelabs on PRs using the legacy View Engine
build. Switching that build to Ivy is not trivial and there are various
options:

  1. Updating the R3 switches to use POST_R3 by default. At first glance,
  this doesn't look easy because the current ngtsc switch logic seems to
  be unidirectional (only PRE_R3 to POST_R3).

  2. Updating the legacy setup to run with Ivy. This sounds like the easiest
  solution at first.. but it turns out to be way more complicated. Packages
  would need to be built with ngtsc using legacy tools (i.e. first building
  the compiler-cli; and then building packages) and View Engine only tests
  would need to be determined and filtered out. Basically it will result in
  re-auditing all test targets. This is contradictory to the fact that we have
  this information in Bazel already.

  3. Creating a new job that runs tests on Saucelabs with Bazel. We specify
  fine-grained test targets that should run. This would be a good start
  (e.g. acceptance tests) and also would mean that we do not continue maintaining
  the legacy setup..

This commit implements the third option as it allows us to move forward
with the general Bazel migration. We don't want to spend too much time
on our legacy setup since it will be removed anyway in the future.

PR Close #34277
2019-12-16 07:43:41 -08:00
..
dist build: update zone.js to use the new rollup_bundle (#33329) 2019-11-15 10:50:14 -08:00
doc build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
example build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
lib fix: implement Symbol.specics of Promise (#34162) 2019-12-03 10:29:04 -08:00
scripts build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
test ci: run acceptance tests on saucelabs with ivy (#34277) 2019-12-16 07:43:41 -08:00
BUILD.bazel build: update zone.js to use the new rollup_bundle (#33329) 2019-11-15 10:50:14 -08:00
CHANGELOG.md release: cut the zone.js-0.10.2 release (#32128) 2019-08-13 16:55:04 -07:00
DEVELOPER.md docs(zone.js): update release docs instructions (#32128) 2019-08-13 16:55:03 -07:00
MODULE.md build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
NON-STANDARD-APIS.md build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
README.md fix(zone.js): update dart zone link (#31646) 2019-07-23 21:12:52 -07:00
SAMPLE.md build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
STANDARD-APIS.md build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
bundles.bzl build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
check-file-size.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
file-size-limit.json build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
karma-base.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
karma-build-jasmine-phantomjs.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
karma-build-jasmine.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
karma-build-jasmine.es2015.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
karma-build-mocha.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
karma-build-sauce-mocha.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
karma-build-sauce-selenium3-mocha.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
karma-build.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
karma-dist-jasmine.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
karma-dist-mocha.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
karma-dist-sauce-jasmine.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
karma-dist-sauce-jasmine.es2015.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
karma-dist-sauce-jasmine3.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
karma-dist-sauce-selenium3-jasmine.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
karma-dist.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
karma-evergreen-dist-jasmine.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
karma-evergreen-dist-sauce-jasmine.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
karma-evergreen-dist.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
package.json build: remove vendored Babel typings (#33226) 2019-10-17 18:45:52 -04:00
presentation.png build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
promise-adapter.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
promise-test.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
promise.finally.spec.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
rollup-es5.config.js build: fix zone.js version stamping after updating to new rollup_bundle (#33329) 2019-11-15 10:50:14 -08:00
rollup-es5_global-es2015.config.js build: fix zone.js version stamping after updating to new rollup_bundle (#33329) 2019-11-15 10:50:14 -08:00
sauce-evergreen.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
sauce-selenium3.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
sauce.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
sauce.es2015.conf.js build: move zone.js to angular repo (#30962) 2019-06-20 11:27:39 -07:00
simple-server.js fix(zone.js): a path traversal attack in test (#32392) 2019-08-30 12:44:46 -07:00
tsconfig.json build: remove vendored Babel typings (#33226) 2019-10-17 18:45:52 -04: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.

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

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

Promises/A+ 1.1 compliant

License

MIT