commonjs-justhere
CommonJS browser bundler with aliasing, extensibility, and source maps from the minified JS bundle
Last updated 2 months ago by yunxu1019 .
BSD3 · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install commonjs-justhere 
SYNC missed versions from official npm registry.

CommonJS Justhere

更新了原 CommonJS Everywhere 中的一些陈旧的依赖项,添加了对typescript的支持。English Version

CommonJS Everywhere

CommonJS(节点模块)浏览器绑定器,具有从缩小的JS绑定到原始源的源映射、浏览器重写的别名以及任意编译到JS语言支持的扩展性。

安装

npm install -g commonjs-justhere

使用

命令行

$ bin/cjsify --help

  用法: cjsify OPT* path/to/entry-file.ext OPT*

  -a, --alias ALIAS:TO      将ALIAS标识的文件的要求替换为`TO`
  -h, --handler EXT:MODULE  使用扩展名EXT和MODULE模块处理文件
  -m, --minify              压缩输出
  -o, --output FILE         输出到FILE而不是stdout
  -r, --root DIR            相对路径是相对于DIR的;默认值:cwd
  -s, --source-map FILE     将源映射输出到FILE
  -v, --verbose             输出详细日志
  -w, --watch               监视输入文件/依赖项的更改并重新生成捆绑包
  -x, --export NAME         指定输出名为NAME
  --deps                    仅列出依赖项而不绑定
  --help                    显示帮助信息并退出
  --ignore-missing          当依赖项解析失败时继续
  --inline-source-map       将sourcemap作为数据URI包含在生成的包中
  --inline-sources          在生成的sourcemap中包含源内容;默认值:on
  --node                    包括process对象;模拟node环境;默认值:on
  --version                 显示版本号并退出

注意: 使用-作为条目文件接受javascript而不是stdin.

注意: 要禁用某个选项,请在其前面加上 no- ,例如: --no-node

示例:

一般用法

cjsify src/entry-file.js --export MyLibrary --source-map my-library.js.map >my-library.js

监视条目文件及其依赖项,以及新添加的依赖项。请注意,只有需要重建的文件在其依赖项时才被访问。这是一种比简单地重建一切更有效的方法。

cjsify -wo my-library.js -x MyLibrary src/entry-file.js

使用特定于浏览器的版本/lib/node compatible.js(记住使用“根”相对路径作为别名)。空别名目标用于在需要源模块时将错误延迟到运行时(在本例中为fs)。

cjsify -a /lib/node-compatible.js:/lib/browser-compatible.js -a fs: -x MyLibrary lib/entry-file.js

模块接口

cjsify(entryPoint, root, options) → Spidermonkey AST

绑定给定文件及其依赖项;返回绑定的spidermonkey AST表示。通过'escodegen'运行ast以生成js代码。

  • entrypoint是一个相对于process.cwd()的文件,该文件将是标记为包含在包中的初始模块以及导出的模块
  • root相对于哪个路径;默认为'process.cwd()`.
  • options是一个可选对象(默认为‘’’),具有以下零个或多个属性
    • export:要添加到全局作用域的变量名;从'entrypoint'模块分配导出的对象。可以提供任何有效的[左侧表达式](http://es5.github.com/x11.2)。
    • aliases:其键和值为“根”根路径(/src/file.js)的对象,表示将替换的值需要解析为关联键
    • handlers:一个对象,其键是文件扩展名(.roy),其值是从文件内容到spidermonkey格式js ast(如esprima生成的格式)或js字符串的函数。默认情况下包括coffeescript和json的处理程序。如果没有为文件扩展名定义处理程序,则假定它是javascript。
    • node:一个错误的值会导致绑定阶段忽略模拟节点环境的'process'存根。
    • verbose: 将其他操作信息记录到stderr
    • ignoreMissing: 忽略依赖缺失的问题

示例

命令行用法

假设我们有以下目录树:

* todos/
  * components/
    * users/
      - model.coffee
    * todos/
      - index.coffee
  * public/
    * javascripts/

运行以下命令将index.coffee及其依赖项导出为app.todos

cjsify -o public/javascripts/app.js -x App.Todos -r components components/todos/index.coffee

由于上面的命令将components指定为unqualified requires的根目录,因此我们可以使用require 'users/model'来要求'components/users/model.coffee'。输出文件将是'public/javascripts/app.js`。

Node 模块示例

jsAst = (require 'commonjs-justhere').cjsify 'src/entry-file.coffee', __dirname,
  export: 'MyLibrary'
  aliases:
    '/src/module-that-only-works-in-node.coffee': '/src/module-that-does-the-same-thing-in-the-browser.coffee'
  handlers:
    '.roy': (roySource, filename) ->
      # Roy编译器现在输出JS代码,所以我们用esprima分析它。
      (require 'esprima').parse (require 'roy').compile roySource, {filename}

{map, code} = (require 'escodegen').generate jsAst,
  sourceMapRoot: __dirname
  sourceMapWithCode: true
  sourceMap: true

简单输出

Current Tags

  • 1.0.1                                ...           latest (2 months ago)

5 Versions

  • 1.0.1                                ...           2 months ago
  • 1.0.0                                ...           6 months ago
  • 0.9.7-d                                ...           9 months ago
  • 0.9.7-c                                ...           9 months ago
  • 0.9.7                                ...           9 months ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 10
Dependencies (20)
Dev Dependencies (4)
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |