码迷,mamicode.com
首页 > Web开发 > 详细

webpack 支持的模块方法

时间:2019-01-28 18:23:37      阅读:262      评论:0      收藏:0      [点我收藏+]

标签:oss   注意   简单   filter   tip   性能   use   多个   包含   

webpack中支持的模块语法风格有:ES6,commonJS和AMD

ES6风格(推荐)

在webpack2中,webpack支持ES6模块语法。这意味着在没有babel等工具处理的情况下你就可以使用import和export。下面的方法在webpack中被支持:

import

静态地导入其他模块的导出

import MyModule from ‘./my-module.js‘;
import { NamedExport } from ‘./other-module.js‘;

注:import只能静态的导入其他模板。不能在其他逻辑或者包含变量中动态使用

export

导出变量,函数

import()

import(‘path/to/module‘) -> promise

 import()在运行期间动态的加载模块,它在内部依赖promise。import()的调用被视为一个分割点,这意味着请求的模块以及它的子模块被分隔到单个的包中。

if(module.hot) {
     import(‘loadsh‘).then(_ => {
         // Do something with lodash (a.k.a ‘_‘)...
     })
 }

 import()的注释

行内注释让import()更加地强大。添加注释到import()中,使我们能够对模块进行命名以及选择不同的模式。下面有一些列子:

 // single target
    import(
        /* webpackChunkName: "my-chunk-name" */
        /* webpackMode: "lazy" */
        ‘module‘
    )
    // Multiple possible targets
    import(
       /* webpackInclude: /\.json$/ */
      /* webpackExclude: /\.noimport\.json$/ */
      /* webpackChunkName: "my-chunk-name" */
      /* webpackMode: "lazy" */
      /* webpackPrefetch: true */
      /* webpackPreload: true */
      `./locale/${language}`
    )

    import(
        /* webpackIgnore: true */
        ‘ignored-module.js‘
    )

 行内注释可设置的属性

  1. webpackIgnore: 如果将webpackIgnore被设置为true,将不能动态导入
  2. webpackChunkName:给包命名。从2.6.0起,占位符[index]和[request]在给定的字符串中被支持,[index]为递增的数字,[request]为实际解析的文件名。在注释中添加webpackChunkName:‘my-chunk-name‘,这会使分隔的包名为 [my-chunk-name].js而不是[id].js
  3. webpackPrefetch:告诉浏览器,这个资源在将来可能会被需要用于一些导航。
  4. webpackPreload:告诉浏览器,这个资源在当前导航中可能会需要。
  5. webpackMode:从2.6.0起,能够指定不同的动态导入模式。可选项如下:
    • ‘lazy‘(default):为每一个import()的模块生成一个懒加载chunk。
    • ‘lazy-once‘:只生成一个满足所有import()调用的懒加载chunk。在第一次调用import()时就会去获取chunk,在之后调用import()会使用相同的网络响应。注意这只在部分动态语句中才有意义,例如:import(`./locales/${language}.json`),这儿可能有多个模块路径被请求。
    • ‘eager‘:不生成额外的chunk,所有的模块被包含中当前的chunk中并且不会增加额外的网络请求。只要被解析,promise依然会返回。与静态导入不同的是,直到调用import(),module才会被执行
    • ‘weak‘:如果模块功能已经在其他地方被加载了(如:在其他模块中导入了它或者加载了包含这个模块的脚本),就尝试去加载这个模块。promise依然会返回,但是只有当chunk已经在客户端了才会resolve,如果模块不可用就会reject。不会发送网络请求。
    • ‘webpackInclude‘:在导入期间这个正则表达式会用于匹配,只有被匹配到的模块才会被打包。
    • ‘webpackExclude‘:在导入期间这个正则表达式会用于匹配,只要是被匹配到的模块就不会被打包。

commonJS

commonJS的目标是为浏览器之外的JavaScript指定一个生态系统。下面的commonJS方法在webpack中被支持:

require

 require(dependency: String);

 从其他的模块中同步检索exports。编辑器会确认在输出包中依赖是可用的

var $ = require(‘jquery‘);
var myModule = require(‘my-module‘);

 require.resolve

var ID = require.resolve(dependency: String);

 同步检索模块ID,编辑器会确认在输出包中依赖是可用的

require.cache

对同一个模块的多次require,只有一个模块执行并且只有一次导出。这是因为在运行期间存在cache。从cache中移除值这会导致新的模块执行以及新的导出。

var d1 = require(‘dependency‘);
    require(‘dependency‘) === d1;
    delete require.cache[require.resolve(‘dependency‘)];
    require(‘dependency‘) !== d1;

    // in file.js
    require.cache[module.id] === module;
    require(‘./file.js‘) === module.exports;
    delete require.cache[module.id];
    require.cache[module.id] === undefined;
    require(‘./file.js‘) !== module.exports; // in theory; in praxis this causes a stack overflow
    require.cache[module.id] !== module;

 require.ensure

 require.ensure(
      dependencies: String[],
      callback: function(require),
      errorCallback: function(error),
      chunkName: String
    )

 分隔指定的依赖到单独的包中,并且包会被异步加载。使用commonJs语法这是唯一一种动态加载包的方式。这意味着,该代码可以在执行中运行,只有在满足某些条件时才加载依赖项。这个功能在内部依赖promise

if ( module.hot ) {
  require.ensure([‘b‘], function(require) {
    var c = require(‘c‘);

    // Do something special...
  });

 require.ensure支持如下参数:

  1. dependencies:字符串数组。声明在callback要执行的所有模块。
  2. callback:一个函数。当所有的依赖加载完成就会这些这个回调函数。require会作为这个函数的参数,在函数中可以使用require去引入其他的依赖。
  3. errorCallback:如果依赖加载失败就会执行这个函数
  4. chunkName:给通过require.ensure()创建的包名指定一个名字

AMD

AMD是一个JavaScript规范,它为书写模块,加载模板定义了接口。在webpack中支持如下的AMD方法

define (with factory)

define([name: String], [dependencies: String[]], factoryMethod: function(...))

 如果提供了dependencies,factoryMethod会带着每个dependency输出(按dependencies的相同顺序)被调用,如果dependencies没有被提供,factoryMethod会带着require, exports 和 module被调用,如果这个函数有返回值,这个值会作为模块的输出。webpack会忽略name

define([‘jquery‘, ‘my-module‘], function($, myModule) {
  // Do something with $ and myModule...

  // Export a function
  return function doSomething() {
    // ...
  };
});

 它不能在异步函数中使用

define (with value)

define(value: !Function)

 

define({
  answer: 42
});

 简单的导出value,这儿的value可以是除函数之外的任何值

require (amd-version)

require(dependencies: String[], [callback: function(...)])

 它与require.ensure()类似。它会分隔dependencies到一个独立中包中,并且这个包会被异步加载

require([‘b‘], function(b) {
  var c = require(‘c‘);
});

 webpack

除了上面描述的模块语法之外,webpack还提供了一些webpack特有的方法

require.context

require.context(
  directory: String,
  includeSubdirs: Boolean /* optional, default true */,
  filter: RegExp /* optional, default /^\.\/.*$/, any file */,
  mode: String  /* optional, ‘sync‘ | ‘eager‘ | ‘weak‘ | ‘lazy‘ | ‘lazy-once‘, default ‘sync‘ */
)

 require.include

require.include(dependency: String)

 在不执行依赖项的情况下包含依赖项.在优化性能时非常有用

require.include(‘a‘);
require.ensure([‘a‘, ‘b‘], function(require) { /* ... */ });
require.ensure([‘a‘, ‘c‘], function(require) { /* ... */ });

 这会生成如下输出:

  • 入口chunk:file.js 和 a
  • 异步chunk:b
  • 异步chunk:c

如果没有使用require.include(‘a‘)。a会被复制在两个anonymous chunk中

webpack 支持的模块方法

标签:oss   注意   简单   filter   tip   性能   use   多个   包含   

原文地址:https://www.cnblogs.com/QxQstar/p/10331205.html

(1)
(1)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!