fis3-hook-commonjs

fis3 已经默认不自带模块化开发支持，那么如果需要采用 commonjs 规范作为模块化开发，请使用此插件。

请配合 mod.js 一起使用。

注意：需要对目标文件设置 isMod 属性，说明这些文件是模块化代码。

``js
fis.match('/modules/**.js', {
isMod: true
})
`

这样才会被自动包装成 amd，才能在浏览器里面运行（当然还得依靠 mod.js）。

另外，所有 isMod 为 true 的文件都会被包裹成 AMD, 如果不想包裹，请设置 wrap 属性为 false。

设置了 isMod 为 true 的文件可以在 js 里面直接通过 require('文件路径') 的方式来使用，支持相对路径和绝对路径。

`js
var $ = require('/static/lib/jquery.js');

require('./index.js');
`

如果存在部分模块化文件不是以 commonjs 规范编写的，该插件可以通过配置文件属性 umd2commonjs 尝试兼容。

`
fis.match('/node_modules/echarts/**.js', {
umd2commonjs: true
})
`

同时某些 js 内部有很多 require 的用法，如果希望 fis 忽略这部分依赖，可以设置 ignoreDependencies 如:

`
fis.match('/node_modules/echarts/**.js', {
ignoreDependencies: true
})
`

自定义模块ID

插件默认使用资源的绝对路径作为模块ID，如果希望更改模块ID，需要对目标文件设置 moduleId 属性

`js
fis.match('/modules/(**).js', {
isMod: true,
moduleId: '$1'
})
`

通过上述配置，我们可以将 /modules/A.js 的模块ID由 modules/A 改变为 A

安装

全局安装或者本地安装都可以。

`
npm install -g fis3-hook-commonjs
`

或者

`
npm install fis3-hook-commonjs
`

用法

在 fis-conf.js 中加入以下代码。


`js
fis.hook('commonjs', {
// 配置项
});
`

注意

虽然支持 paths 和 packages 设置，目的主要是为了迁移代码用的，从零开发，推荐直接使用 require('文件路径') 的方式，更简单明了。

配置项

以下所有配置都是可选配置。简单使用可以跳过。

* baseUrl 默认为 . 即项目根目录。用来配置模块查找根目录。
* paths 用来设置别名，路径基于 baseUrl 设置。

`js
fis.hook('commonjs', {
paths: {
$: '/modules/jquery/jquery-1.11.2.js'
}
});
`
* packages 用来配置包信息，方便项目中引用。

`js
fis.hook('commonjs', {
packages: [
{
name: 'foo',
location: './modules/foo',
main: 'index.js'
}
]
});
`

* 当 require('foo') 的时候等价于 require('/modules/foo/index.js').
* 当 require('foo/a.js') 的时候，等价于 require('/modules/foo/a.js').
* forwardDeclaration 默认为 false, 用来设置是否开启依赖前置，根据前端加载器来定，mod.js 是不需要的。
* skipBuiltinModules 默认为 true, 只有在 forwardDeclaration 启动的时候才有效，用来设置前置依赖列表中是否跳过内置模块如： require, module, exports。
* extList 默认为 ['.js', '.coffee', '.jsx', '.es6']，当引用模块时没有指定后缀，该插件会尝试这些后缀。
* tab 默认为 2, 用来设置包裹时，内容缩进的空格数。
* ignoreDependencies 默认为 空，用来忽略掉对某些资源 require，一般用来忽略掉内部实现的 require 资源。

`js
fis.hook('commonjs', {
// 忽略 angular2 的依赖。我自己负责加载需要资源。
ignoreDependencies: [
'angular2/**',
]
});
``