JarCastingRxJS System Bundle
This package provides a System bundle of RxJS. This is only a convenience package, it does not add or change any functionality.
RxJS itself is found here:
https://github.com/ReactiveX/rxjs
The official NPM package provided by the RxJS project provide only source files and a UMD bundle. For reasons discussed in the RxJS issue tracker, the project no longer provides its own System bundles.
Where is this useful?
An NPM-published System bundle is very convenient for use in a Plunkr or other contexts where a local build process is avoided. All of this probably makes a lot of sense to you if you are familiar with Angular 2+ (which depends on RxJS) and SystemJS. However, neither RxJS nor this repackaging are specific to Angular.
Versions
I will attempt to update this package for each new version of RxJS, from 5.0.1 onward. Each version of this bundle package exactly matching each underlying RxJS version. Sometime there is -N added to the end of the version, for tweaks to this bundling mechanism/repo which don't affect the RxJS version.
To list all available versions, use npm:
npm show rxjs-system-bundle@* version
CDN
Conveniently, the Unpkg service provides a CDN for NPM package contents. Therefore the System bundle is available at a URL like this:
https://unpkg.com/rxjs-system-bundle@VERSIONHERE/Rx.system.min.js
(Change VERSIONHERE to the RxJS version).
Both minified and plain variations are published, both including source maps. To see the exact filenames available, install the package locally:
npm install rxjs-system-bundle
and look in node_modules/rxjs-system-bundle, or look at:
https://unpkg.com/rxjs-system-bundle@VERSIONHERE/
(The set of files is the same for each version.)
See it in action
The following Plunkr illustrates use of this package. Of course there are many other practical uses, but this one can be seen with one click. Unlike a default Angular 2+ plunker, this one uses only a single request for all of RxJS.
https://plnkr.co/edit/Fy0jvu?p=preview
To see how to configure System to use this RxJS System bundle, see the Plunkr or the configuration snippet below.
System.config({
transpiler: 'typescript',
typescriptOptions: {
emitDecoratorMetadata: true
},
paths: {
'npm:': 'https://unpkg.com/'
},
bundles: {
"npm:[email protected]/Rx.system.js": [
"rxjs",
"rxjs/*",
"rxjs/operator/*",
"rxjs/observable/*",
"rxjs/scheduler/*",
"rxjs/symbol/*",
"rxjs/add/operator/*",
"rxjs/add/observable/*",
"rxjs/util/*"
]
},
map: {
'app': './src',
'@angular/core': 'npm:@angular/core/bundles/core.umd.js',
'@angular/common': 'npm:@angular/common/bundles/common.umd.js',
'@angular/compiler': 'npm:@angular/compiler/bundles/compiler.umd.js',
'@angular/platform-browser': 'npm:@angular/platform-browser/bundles/platform-browser.umd.js',
'@angular/platform-browser-dynamic': 'npm:@angular/platform-browser-dynamic/bundles/platform-browser-dynamic.umd.js',
'@angular/http': 'npm:@angular/http/bundles/http.umd.js',
'@angular/router': 'npm:@angular/router/bundles/router.umd.js',
'@angular/forms': 'npm:@angular/forms/bundles/forms.umd.js',
'@angular/core/testing': 'npm:@angular/core/bundles/core-testing.umd.js',
'@angular/common/testing': 'npm:@angular/common/bundles/common-testing.umd.js',
'@angular/compiler/testing': 'npm:@angular/compiler/bundles/compiler-testing.umd.js',
'@angular/platform-browser/testing': 'npm:@angular/platform-browser/bundles/platform-browser-testing.umd.js',
'@angular/platform-browser-dynamic/testing': 'npm:@angular/platform-browser-dynamic/bundles/platform-browser-dynamic-testing.umd.js',
'@angular/http/testing': 'npm:@angular/http/bundles/http-testing.umd.js',
'@angular/router/testing': 'npm:@angular/router/bundles/router-testing.umd.js',
'typescript': 'npm:[email protected]/lib/typescript.js'
},
packages: {
app: {
main: './main.ts',
defaultExtension: 'ts'
},
rxjs: {
defaultExtension: false
}
}
});
