dde68ff954
* it's tricky to get out of the runfiles tree with `bazel test` as `BUILD_WORKSPACE_DIRECTORY` is not set but I employed a trick to read the `DO_NOT_BUILD_HERE` file that is one level up from `execroot` and that contains the workspace directory. This is experimental and if `bazel test //:test.debug` fails than `bazel run` is still guaranteed to work as `BUILD_WORKSPACE_DIRECTORY` will be set in that context * test //integration:bazel_test and //integration:bazel-schematics_test exclusively * run "exclusive" and "manual" bazel-in-bazel integration tests in their own CI job as they take 8m+ to execute ``` //integration:bazel-schematics_test PASSED in 317.2s //integration:bazel_test PASSED in 167.8s ``` * Skip all integration tests that are now handled by angular_integration_test except the tests that are tracked for payload size; these are: - cli-hello-world* - hello_world__closure * add & pin @babel deps as newer versions of babel break //packages/localize/src/tools/test:test @babel/core dep had to be pinned to 7.6.4 or else //packages/localize/src/tools/test:test failed. Also //packages/localize uses @babel/generator, @babel/template, @babel/traverse & @babel/types so these deps were added to package.json as they were not being hoisted anymore from @babel/core transitive. NB: integration/hello_world__systemjs_umd test must run with systemjs 0.20.0 NB: systemjs must be at 0.18.10 for legacy saucelabs job to pass NB: With Bazel 2.0, the glob for the files to test `"integration/bazel/**"` is empty if integation/bazel is in .bazelignore. This glob worked under these conditions with 1.1.0. I did not bother testing with 1.2.x as not having integration/bazel in .bazelignore is correct. PR Close #33927 |
||
---|---|---|
.. | ||
dist | ||
doc | ||
example | ||
lib | ||
scripts | ||
test | ||
BUILD.bazel | ||
CHANGELOG.md | ||
DEVELOPER.md | ||
MODULE.md | ||
NON-STANDARD-APIS.md | ||
README.md | ||
SAMPLE.md | ||
STANDARD-APIS.md | ||
bundles.bzl | ||
check-file-size.js | ||
file-size-limit.json | ||
karma-base.conf.js | ||
karma-build-jasmine-phantomjs.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 | ||
presentation.png | ||
promise-adapter.js | ||
promise-test.js | ||
promise.finally.spec.js | ||
rollup-es5.config.js | ||
rollup-es5_global-es2015.config.js | ||
sauce-evergreen.conf.js | ||
sauce-selenium3.conf.js | ||
sauce.conf.js | ||
sauce.es2015.conf.js | ||
simple-server.js | ||
tsconfig.json |
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