angular-docs-cn/packages/zone.js
JiaLiPassion c2b4d92708 feat(zone.js): patch jasmine.createSpyObj to make properties enumerable to be true (#34624)
Close #33657

in jasmine 3.5, there is a new feature, user can pass a properties object to `jasmine.createSpyObj`

```
const spy = jasmine.createSpyObj('spy', ['method1'], {prop1: 'foo'});
expect(spy.prop1).toEqual('foo');
```

This case will not work for Angular TestBed, for example,

```
describe('AppComponent', () => {
  beforeEach(() => {

    //Note the third parameter
    // @ts-ignore
    const someServiceSpy = jasmine.createSpyObj('SomeService', ['someFunction'], ['aProperty']);

    TestBed.configureTestingModule({
      declarations: [
        AppComponent
      ],
      providers: [
        {provide: SomeService, useValue: someServiceSpy},
      ]
    }).compileComponents();

  });

  it('should create the app', () => {
    //spyObj will have someFunction, but will not have aProperty
    let spyObj = TestBed.get(SomeService);
  });
```

Because `jasmine.createSpyObj` will create the `aProperty` with `enumerable=false`,
and `TestBed.configureTestingModule` will try to copy all the properties from spyObj to
the injected service instance. And because `enumerable` is false, so the property (here is aProperty)
will not be copied.

This PR will monkey patch the `jasmine.createSpyObj` and make sure the new property's
`enumerable=true`.

PR Close #34624
2020-06-29 12:22:08 -07:00
..
bundles feat(zone.js): upgrade zone.js to angular package format(APF) (#36540) 2020-06-11 11:08:48 -07:00
dist feat(zone.js): upgrade zone.js to angular package format(APF) (#36540) 2020-06-11 11:08:48 -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 feat(zone.js): patch jasmine.createSpyObj to make properties enumerable to be true (#34624) 2020-06-29 12:22:08 -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 feat(zone.js): patch jasmine.createSpyObj to make properties enumerable to be true (#34624) 2020-06-29 12:22:08 -07:00
testing feat(zone.js): upgrade zone.js to angular package format(APF) (#36540) 2020-06-11 11:08:48 -07:00
BUILD.bazel feat(zone.js): move all zone optional bundles to plugins folders (#36540) 2020-06-11 11:08:48 -07: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): upgrade zone.js to angular package format(APF) (#36540) 2020-06-11 11:08:48 -07: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 build: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04: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 build: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04: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 feat(zone.js): upgrade zone.js to angular package format(APF) (#36540) 2020-06-11 11:08:48 -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: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04:00
tools.bzl feat(zone.js): upgrade zone.js to angular package format(APF) (#36540) 2020-06-11 11:08:48 -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