這次帶給大家webpack dev server使用詳解,webpack dev server使用詳解的注意事項有哪些,下面就是實戰案例,一起來看一下。
webpack-dev-server
webpack-dev-server是一個小型的Node.js Express伺服器,它使用webpack-dev-middleware來服務webpack的套件,除此自外,它還有一個透過Sock.js來連接到伺服器的微型執行時間.
我們來看一下下面的設定檔(webpack.config.js)
var path = require("path"); module.exports = { entry:{ app:["./app/main.js"] }, output:{ path:path.resolve(__dirname,"build"), publicPath:"/assets/", filename:"bundle.js" } }
這裡你將你的來源檔案放在app資料夾下,並透過webpack將其打包到build資料夾下的bundle.js中.
注意:webpack-dev-server是一個獨立的NPM套件,你可以透過npm install webpack-dev-server來安裝它.
#基本目錄
webpack-dev-server預設會以目前目錄為基本目錄,除非你制定它.
webpack-dev-server --content-base build/
上述命令是在命令行中執行的,它將build目錄作為根目錄.有一點需要注意的是:webpack-dev-server生成的包並沒有放在你的真實目錄中,而是放在了內存中.
我們在基本目錄下新建一個index.html檔,然後在瀏覽器中輸入http://localhost:8080訪問.
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Document</title> </head> <body> <script src="assets/bundle.js"></script> </body> </html>
自動刷新
webpack-dev-server支援兩種模式來自動刷新頁面.
iframe模式(頁面放在iframe中,當發生改變時重載)
inline模式(將webpack-dev-sever的客戶端入口新增至套件(bundle))
#兩種模式都支援熱模組替換(Hot Module Replacement).熱模組替換的好處是只替換更新的部分,而不是頁面重載.
iframe模式
使用這種模式不需要額外的配置,只需要以下面這種URL格式存取即可
http://«host»:«port»/webpack-dev-server/«path»
例如:http://localhost:8080/webpack-dev-server/index.html.
#inline模式
inline模式下我們造訪的URL不用改變,啟用這種模式分兩種情況:
1 當以命令列啟動webpack-dev-server時,需要做兩點:
在指令行中新增--inline指令
在webpack.config.js中加入devServer:{inline:true}
2 當以Node .js API啟動webpack-dev-server時,我們也需要做兩點:
#由於webpack-dev-server的配置中無inline選項,我們需要加入webpack-dev- server/client?http://«path»:«port»/到webpack配置的entry入口點.
將加入html檔案中
var config = require("./webpack.config.js"); var webpack = require('webpack'); var WebpackDevServer = require('webpack-dev-server'); config.entry.app.unshift("webpack-dev-server/client?http://localhost:8080/"); var compiler = webpack(config); var server = new WebpackDevServer(compiler, { contentBase:'build/', publicPath: "/assets/" }); server.listen(8080);
在Node中執行上面的程式碼即可。
注意:webpack配置中的devSever配置項目只對在命令列模式有效。
(Hot Module Replacement)熱模組替換
在命令列運行inline模式,並啟用熱模組替換
這裡只需要多增加--hot指令就OK了.如下所示.
webpack-dev-server --content-base build --inline --hot
注意:命令列模式下,webpack.config.js中一定要配置output.publicPath來指定編譯後的包(bundle)的存取位置.
在Nodejs API中執行inline模式,並啟用熱模組替換
這裡需要做以下三點:
在webpack.config. js的entry選項中新增:webpack/hot/dev-server
在webpack.config.js的plugins選項中新增:new webpack.HotModuleReplacementPlugin()
#在webpack-dev-server的設定中加入:hot:true
webpack-dev-server中的設定選項
var WebpackDevServer = require("webpack-dev-server"); var webpack = require("webpack"); var compiler = webpack({ // configuration }); var server = new WebpackDevServer(compiler, { // webpack-dev-server options contentBase: "/path/to/directory", // Can also be an array, or: contentBase: "http://localhost/", hot: true, // Enable special support for Hot Module Replacement // Page is no longer updated, but a "webpackHotUpdate" message is send to the content // Use "webpack/hot/dev-server" as additional module in your entry point // Note: this does _not_ add the `HotModuleReplacementPlugin` like the CLI option does. // Set this as true if you want to access dev server from arbitrary url. // This is handy if you are using a html5 router. historyApiFallback: false, // Set this if you want to enable gzip compression for assets compress: true, // Set this if you want webpack-dev-server to delegate a single path to an arbitrary server. // Use "**" to proxy all paths to the specified server. // This is useful if you want to get rid of 'http://localhost:8080/' in script[src], // and has many other use cases (see https://github.com/webpack/webpack-dev-server/pull/127 ). proxy: { "**": "http://localhost:9090" }, setup: function(app) { // Here you can access the Express app object and add your own custom middleware to it. // For example, to define custom handlers for some paths: // app.get('/some/path', function(req, res) { // res.json({ custom: 'response' }); // }); }, // pass [static options](http://expressjs.com/en/4x/api.html#express.static) to inner express server staticOptions: { }, // webpack-dev-middleware options quiet: false, noInfo: false, lazy: true, filename: "bundle.js", watchOptions: { aggregateTimeout: 300, poll: 1000 }, // It's a required option. publicPath: "/assets/", headers: { "X-Custom-Header": "yes" }, stats: { colors: true } }); server.listen(8080, "localhost", function() {}); // server.close();
相信看了本文案例你已經掌握了方法,更多精彩請關注php中文網其它相關文章!
推薦閱讀:
以上是webpack+dev+server使用詳解的詳細內容。更多資訊請關注PHP中文網其他相關文章!