fis3-hook-module

Deprecated 不再更新

已被拆分成多个插件，放一起容易带来麻烦，请迁移对应的插件中。

Common Js 方案请使用 fis3-hook-commonjs
AMD 方案请使用 fis3-hook-amd
CMD 方案请使用 fis3-hook-cmd

fis3 已经默认不自带模块化开发支持，需要此插件来完成模块化开发的支持。

针对 isMod 为 true 的 js 文件自动 amd 包裹。
针对所有 js 文件和 js 片段，检测 require 语法，自动标记依赖（包括异步依赖）。
扩展 require 路径支持。支持无后缀写法。如：require('./xxx') 等价于 require('./xxx.js').
扩展 require 路径支持。支持 baseUrl、paths 和 packages 配置。详情看配置说明。
针对 mode 设置成 'amd' 的情况下，进行 shim 包裹。详情看配置说明。

安装

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

npm install fis3-hook-module

启用

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

fis.hook('module');

注意

此插件已经集成对模块化资源进行 amd 包裹，无需 jswrapper

通过配置标记哪些 js isMod 为 true 即可.

// 标记 /libs 当前目录下面的 js 文件为模块化 js.
fis.match('/libs/*.js', {
  isMod: true
});

配置说明

fis.hook('module', {

  // 可以通过设置此值来给 js 文件进行包裹。
  // 
  // 可选值：
  // - `amd` 即 amd 包裹
  // - `closure` 即闭包包裹。
  // - 留空时不进行处理，isMod 为 true 的文件除外。isMod 为 true 的文件，会进行 amd 方式包裹。
  wrap: '',

  // 分为两种：
  //
  // `commonJs` 选用此方案，性能最好，规则更简单
  // `amd` 需要词法分析，时间略长。
  //  当设置为 auto 的时候，程序自动判断。
  mode: 'auto',

  // 配置 baseUrl, 配置，页面中的 require 路径都是基于此路径查找的。
  // https://github.com/amdjs/amdjs-api/blob/master/CommonConfig.md#baseurl-
  // baseUrl: '.',

  // 可以给项目中的路径或者文件建立别名。
  // 
  // {
  //   libs: '/static/libs',
  //   jquery: '/static/libs/jquery'
  // }
  // 
  // 那么:
  // 
  // require('libs/alert'); 就等价于 require('/static/libs/alert');
  // requrire('jquery');  等价于： require('/static/libs/jquery');

  // 更多信息请参考。https://github.com/amdjs/amdjs-api/blob/master/CommonConfig.md#paths-
  // paths: {},

  // 后续补充
  // 届时，请参考。https://github.com/amdjs/amdjs-api/blob/master/CommonConfig.md#packages-
  // packages: [],
  
  // 是否依赖前置
  // 即 是否将 factory 中的 require 对象，前置放在 define 的第二个参数中。
  // 对于 amd loader 来说可以免去解析 factory 的操作。推荐给用  amd loader。
  // !!! 用  mod.js 作为 loader 时，勿用!!!!
  forwardDeclaration: false,

  // 当开启依赖前置后有效，用来控制 amd 的内建模块是否需要保留在 deps 第二个参数中。
  // 如: require, exports, module
  // 像 cmd 是不需要的，所以模式是 cmd 时，自动会开启。
  skipBuiltinModules: false,

  // 当 mod 为 amd 时，以下配置才有效。
  
  // 届时，请参考。https://github.com/amdjs/amdjs-api/blob/master/CommonConfig.md#shim-
  // shim: null,
  
  // 是否将全局的 require(['jquery']) 异步用法当成同步？
  // 当成同步，js 加载不再走 loader 而是，直接页面源码中输出 <script> 标签到页面，用 <script> 来加载。
  globalAsyncAsSync: false,

  // 用来设置无后缀引用模块时，对模块的定义的文件查找顺序。
  // 如： require('./main')
  // 查找顺序为：require('./main.js') require('./main.coffee') require('./main.jsx')
  // extList: ['.js', '.coffee', '.jsx']
});

wrap 默认 undefined.

当文件 isMod 为 true 时，会对文件以 amd 的方式包裹。

可选值:
- amd 即 amd 包裹
- closure 即闭包包裹。
- false 或者 null 或者留空时不进行包裹
mode 默认 auto 根据文件内容自动判断是 commonJs 还是 amd。不准确，建议设置其中一种。

分为两种：
- commonJs 选用此方案，性能最好，规则更简单
- amd 需要词法分析，时间略长。
baseUrl 默认为 .。配置 baseUrl, 配置，页面中的 require 路径都是基于此路径查找的。详情见：https://github.com/amdjs/amdjs-api/blob/master/CommonConfig.md#baseurl-
paths 设置引用别名。如：
```
fis.hook('module', {
  paths: {
    libs: '/static/libs',
    jquery: '/static/libs/jquery'
  }
});
```
那么：
- require('libs/alert'); 就等价于 require('/static/libs/alert');
- requrire('jquery'); 等价于： require('/static/libs/jquery');
- 更多配置请参考：https://github.com/amdjs/amdjs-api/blob/master/CommonConfig.md#packages-
packages 用来配置包信息。
forwardDeclaration 默认为 false, 是否依赖前置, 即是否将 factory 中的 require 对象，前置放在 define 的第二个参数中。用 mod.js 作为 loader 时，勿用
skipBuiltinModules 默认 false, 当开启依赖前置后有效，用来控制 amd 的内建模块是否需要保留在 deps 第二个参数中。如: require, exports, module。像 cmd 是不需要的，所以模式是 cmd 时，自动会开启。
shim 届时，请参考。https://github.com/amdjs/amdjs-api/blob/master/CommonConfig.md#shim-
globalAsyncAsSync 默认 false, 是否将全局的 require([‘jquery’]) 异步用法当成同步？当成同步，js 加载不再走 loader 而是，直接页面源码中输出