美文网首页
出口(Output)

出口(Output)

作者: 炎武森禄 | 来源:发表于2017-02-16 13:54 被阅读0次

    output选项影响编译输出。output选项控制 webpack 如何向硬盘写入编译文件。注意,即使可以存在多个入口点,但只指定一个输出配置。

    如果你用了哈希([hash][chunkhash]),请确保模块具有一致的顺序。可以使用 OccurrenceOrderPluginrecordsPath

    用法

    webpack配置中的output属性的最低要求是将其设置为一个对象,包括以下两点:

    你编译出来文件名随你命名,但是我们通常使用 : main.js 或者 bundle.js 或者 index.js

    一个 output.path必须是一个 绝对路径 ,该路径指向你想打包到的目录。

    webpack.config.js

    const config = {
      output: {
        filename: 'bundle.js',
        path: '/home/proj/public/assets'
      }
    };
    
    module.exports = config;
    

    选项

    以下列出可以向 output 属性传入的值。

    output.chunkFilename

    非入口块的文件名,作为 output.path 目录中的相对路径。

    [id] 被 chunk 的 id 替换。

    [name] 被 chunk 的 name 替换(或者当 chunk 没有 name 时使用 id 替换)。

    [hash] 被编译的 hash 替换。

    [chunkhash] 被 chunk 的 hash 替换。

    output.crossOriginLoading

    选项启用跨域加载(cross-origin loading) chunk。

    可能的值有:
    false - 禁用跨域加载
    anonymous - 启用跨域加载。当使用 anonymous
    时,发送请求不带凭据(credential)。
    use-credentials - 启用跨域加载。发送请求带凭据(credential)。
    更多跨域加载信息请查看MDN

    默认值:false

    参考library
    参考Development Tools

    output.devtoolLineToLine

    所有/指定模块启用行到行映射模式。行到行映射模式使用一个简单的 SourceMap,其中生成源码的每一行都映射到原始源码的同一行。这是一个可以性能优化的地方。当你需要更好的性能,并且要确保输入行和生成行匹配时,才会考虑启用。

    true 在所有模块启用(不推荐)

    {test, include, exclude}对象 在特定文件启用(类似于 module.loaders)。

    默认值:disabled

    output.filename

    指定硬盘每个输出文件的名称。在这里你不能指定绝对路径!·output.path· 选项规定了文件被写入硬盘的位置。·filename· 仅用于命名每个文件。

    单入口

    {
      entry: './src/app.js',
      output: {
        filename: 'bundle.js',
        path: __dirname + '/build'
      }
    }
    
    // writes to disk: ./build/bundle.js
    

    多入口

    如果你的配置创建了多个 "chunk"(例如使用多个入口点或使用类似 CommonsChunkPlugin 的插件),你应该使用以下的替换方式来确保每个文件名都不重复。

    [name] 被 chunk 的 name 替换。

    [hash] 被编译(compilation)的 hash 替换。

    [chunkhash]被 chunk 的 hash 替换。

    {
      entry: {
        app: './src/app.js',
        search: './src/search.js'
      },
      output: {
        filename: '[name].js',
        path: __dirname + '/build'
      }
    }
    
    // writes to disk: ./build/app.js, ./build/search.js
    

    output.hotUpdateChunkFilename

    热更新块 的文件名。它们在output.path目录中。

    [id] 被 chunk 的 id 替换。

    [hash] 被编译的 hash 替换。(最后一个 hash 存储在记录中)

    默认值: "[id].[hash].hot-update.js"

    output.hotUpdateFunction

    webpack 用于异步加载热更新块的 JSONP 函数。

    默认值: "webpackHotUpdate"

    output.hotUpdateMainFilename

    热更新主文件的文件名。

    [hash] 被编译的 hash 替换。(最后一个 hash 存储在记录中)

    默认值: "[hash].hot-update.json"

    output.jsonpFunction

    webpack 用于异步加载块(chunk)的 JSONP 函数。

    较短的函数可能会减少文件大小。当单页有多个 webpack 实例时,请使用不同的标识符。

    默认值: "webpackJsonp"

    output.library

    如果设置过,可将包导出为库。output.library 是库的名称。

    如果你正在编写库并且想要将其发布为一个单文件,请使用此选项。

    output.libraryTarget

    导出库的格式

    "var" - 通过设置一个变量导出:var Library = xxx(默认)

    "this" - 通过设置this的一个属性导出:this["Library"] = xxx

    "commonjs" - 通过设置exports的一个属性导出:exports["Library"] = xxx

    "commonjs2" - 通过设置module.exportsmodule.exports = xxx

    "amd" - 导出到 AMD(可选命名 - 通过 library 选项设置名称)

    "umd" - 导出到 AMD,CommonJS2 或者 root 的一个属性

    默认值: "var"

    如果 output.library 未设置,但是 output.libraryTarget 被设置为var以外的值,则导出对象的每个属性都被复制(除了 amdcommonjs2umd)。

    output.path

    绝对路径作为导出目录(必选项)。

    [hash] 被编译的 hash 替换。

    config.js

    output: {
        path: "/home/proj/public/assets",
        publicPath: "/assets/"
    }
    

    index.html

    <head>
      <link href="/assets/spinner.gif"/>
    </head>
    

    接下来是一个更复杂的例子,来说明对资源使用 CDN 和 hash。

    config.js

    output: {
        path: "/home/proj/cdn/assets/[hash]",
        publicPath: "http://cdn.example.com/assets/[hash]/"
    }
    

    注意: 在编译时不知道最终输出文件的publicPath的情况下,publicPath可以留空,并且在入口点文件运行时动态设置。如果你在编译时不知道publicPath,你可以先忽略它,并且在入口点设置 __webpack_public_path__

     __webpack_public_path__ = myRuntimePublicPath
    
    // 其他的应用程序入口
    

    output.sourceMapFilename

    JavaScript 文件 SourceMap 的文件名。它们在output.path目录中。

    [file] 被 JavaScript 文件的文件名替换。

    [id] 被 chunk 的 id 替换。

    [hash] 被编译(compilation)的 hash 替换。

    默认值: "[file].map"

    下一篇:加载器

    相关文章

      网友评论

          本文标题:出口(Output)

          本文链接:https://www.haomeiwen.com/subject/wdicwttx.html