您好,登录后才能下订单哦!
本文小编为大家详细介绍“如何开发vue-dev-server”,内容详细,步骤清晰,细节处理妥当,希望这篇“如何开发vue-dev-server”文章能帮助大家解决疑惑,下面跟着小编的思路慢慢深入,一起来学习新知识吧。
vue-dev-server#how-it-works README
文档上有四句英文介绍。
发现谷歌翻译的还比较准确,我就原封不动的搬运过来。
浏览器请求导入作为原生 ES 模块导入 - 没有捆绑。
服务器拦截对 *.vue 文件的请求,即时编译它们,然后将它们作为 JavaScript 发回。
对于提供在浏览器中工作的 ES 模块构建的库,只需直接从 CDN 导入它们。
导入到 .js 文件中的 npm 包(仅包名称)会即时重写以指向本地安装的文件。 目前,仅支持 vue 作为特例。 其他包可能需要进行转换才能作为本地浏览器目标 ES 模块公开。
本文仓库 vue-dev-server-analysis
# 推荐克隆我的仓库 git clone https://github.com/lxchuan12/vue-dev-server-analysis.git cd vue-dev-server-analysis/vue-dev-server # npm i -g yarn # 安装依赖 yarn # 或者克隆官方仓库 git clone https://github.com/vuejs/vue-dev-server.git cd vue-dev-server # npm i -g yarn # 安装依赖 yarn
一般来说,我们看源码先从package.json
文件开始:
// vue-dev-server/package.json { "name": "@vue/dev-server", "version": "0.1.1", "description": "Instant dev server for Vue single file components", "main": "middleware.js", // 指定可执行的命令 "bin": { "vue-dev-server": "./bin/vue-dev-server.js" }, "scripts": { // 先跳转到 test 文件夹,再用 Node 执行 vue-dev-server 文件 "test": "cd test && node ../bin/vue-dev-server.js" } }
根据 scripts
test
命令。我们来看 test
文件夹。
vue-dev-server/test
文件夹下有三个文件,代码不长。
index.html
main.js
text.vue
如图下图所示。
接着我们找到 vue-dev-server/bin/vue-dev-server.js
文件,代码也不长。
// vue-dev-server/bin/vue-dev-server.js #!/usr/bin/env node const express = require('express') const { vueMiddleware } = require('../middleware') const app = express() const root = process.cwd(); app.use(vueMiddleware()) app.use(express.static(root)) app.listen(3000, () => { console.log('server running at http://localhost:3000') })
原来就是express
启动了端口3000
的服务。重点在 vueMiddleware
中间件。接着我们来调试这个中间件。
鉴于估计很多小伙伴没有用过VSCode
调试,这里详细叙述下如何调试源码。学会调试源码后,源码并没有想象中的那么难。
vue-dev-server/bin/vue-dev-server.js
文件中这行 app.use(vueMiddleware())
打上断点。
找到 vue-dev-server/package.json
的 scripts
,把鼠标移动到 test
命令上,会出现运行脚本
和调试脚本
命令。如下图所示,选择调试脚本。
点击进入函数(F11)
按钮可以进入 vueMiddleware
函数。如果发现断点走到不是本项目的文件中,不想看,看不懂的情况,可以退出或者重新来过。可以用浏览器无痕(隐私)模式(快捷键Ctrl + Shift + N
,防止插件干扰)打开 http://localhost:3000
,可以继续调试 vueMiddleware
函数返回的函数。
如果你的VSCode
不是中文(不习惯英文),可以安装简体中文插件。
如果 VSCode
没有这个调试功能。建议更新到最新版的 VSCode
(目前最新版本 v1.61.2
)。
接着我们来跟着调试学习 vueMiddleware
源码。可以先看主线,在你觉得重要的地方继续断点调试。
不在调试情况状态下,我们可以在 vue-dev-server/bin/vue-dev-server.js
文件中注释 app.use(vueMiddleware())
,执行 npm run test
打开 http://localhost:3000
。
再启用中间件后,如下图。
看图我们大概知道了有哪些区别。
我们可以找到vue-dev-server/middleware.js
,查看这个中间件函数的概览。
// vue-dev-server/middleware.js const vueMiddleware = (options = defaultOptions) => { // 省略 return async (req, res, next) => { // 省略 // 对 .vue 结尾的文件进行处理 if (req.path.endsWith('.vue')) { // 对 .js 结尾的文件进行处理 } else if (req.path.endsWith('.js')) { // 对 /__modules/ 开头的文件进行处理 } else if (req.path.startsWith('/__modules/')) { } else { next() } } } exports.vueMiddleware = vueMiddleware
vueMiddleware
最终返回一个函数。这个函数里主要做了四件事:
对 .vue
结尾的文件进行处理
对 .js
结尾的文件进行处理
对 /__modules/
开头的文件进行处理
如果不是以上三种情况,执行 next
方法,把控制权交给下一个中间件
接着我们来看下具体是怎么处理的。
我们也可以断点这些重要的地方来查看实现。比如:
if (req.path.endsWith('.vue')) { const key = parseUrl(req).pathname let out = await tryCache(key) if (!out) { // Bundle Single-File Component const result = await bundleSFC(req) out = result cacheData(key, out, result.updateTime) } send(res, out.code, 'application/javascript') }
这个函数,根据 @vue/component-compiler 转换单文件组件,最终返回浏览器能够识别的文件。
const vueCompiler = require('@vue/component-compiler') async function bundleSFC (req) { const { filepath, source, updateTime } = await readSource(req) const descriptorResult = compiler.compileToDescriptor(filepath, source) const assembledResult = vueCompiler.assemble(compiler, filepath, { ...descriptorResult, script: injectSourceMapToScript(descriptorResult.script), styles: injectSourceMapsToStyles(descriptorResult.styles) }) return { ...assembledResult, updateTime } }
接着我们来看 readSource
函数实现。
这个函数主要作用:根据请求获取文件资源。返回文件路径 filepath
、资源 source
、和更新时间 updateTime
。
const path = require('path') const fs = require('fs') const readFile = require('util').promisify(fs.readFile) const stat = require('util').promisify(fs.stat) const parseUrl = require('parseurl') const root = process.cwd() async function readSource(req) { const { pathname } = parseUrl(req) const filepath = path.resolve(root, pathname.replace(/^\//, '')) return { filepath, source: await readFile(filepath, 'utf-8'), updateTime: (await stat(filepath)).mtime.getTime() } } exports.readSource = readSource
接着我们来看对 .js 文件的处理
if (req.path.endsWith('.js')) { const key = parseUrl(req).pathname let out = await tryCache(key) if (!out) { // transform import statements // 转换 import 语句 // import Vue from 'vue' // => import Vue from "/__modules/vue" const result = await readSource(req) out = transformModuleImports(result.source) cacheData(key, out, result.updateTime) } send(res, out, 'application/javascript') }
针对 vue-dev-server/test/main.js
转换
import Vue from 'vue' import App from './test.vue' new Vue({ render: h => h(App) }).$mount('#app')
import Vue from "/__modules/vue" import App from './test.vue' new Vue({ render: h => h(App) }).$mount('#app')
recast
validate-npm-package-name
也就是针对 npm
包转换。 这里就是 "/__modules/vue"
import Vue from 'vue' => import Vue from "/__modules/vue"
import Vue from "/__modules/vue"
这段代码最终返回的是读取路径 vue-dev-server/node_modules/vue/dist/vue.esm.browser.js
下的文件。
if (req.path.startsWith('/__modules/')) { // const key = parseUrl(req).pathname const pkg = req.path.replace(/^\/__modules\//, '') let out = await tryCache(key, false) // Do not outdate modules if (!out) { out = (await loadPkg(pkg)).toString() cacheData(key, out, false) // Do not outdate modules } send(res, out, 'application/javascript') }
目前只支持 Vue
文件,也就是读取路径 vue-dev-server/node_modules/vue/dist/vue.esm.browser.js
下的文件返回。
// vue-dev-server/loadPkg.js const fs = require('fs') const path = require('path') const readFile = require('util').promisify(fs.readFile) async function loadPkg(pkg) { if (pkg === 'vue') { // 路径 // vue-dev-server/node_modules/vue/dist const dir = path.dirname(require.resolve('vue')) const filepath = path.join(dir, 'vue.esm.browser.js') return readFile(filepath) } else { // TODO // check if the package has a browser es module that can be used // otherwise bundle it with rollup on the fly? throw new Error('npm imports support are not ready yet.') } } exports.loadPkg = loadPkg
至此,我们就基本分析完毕了主文件和一些引入的文件。对主流程有个了解。
最后我们来看上文中有无 vueMiddleware 中间件的两张图总结一下:
启用中间件后,如下图。
浏览器支持原生 type=module
模块请求加载。vue-dev-server
对其拦截处理,返回浏览器支持内容,因为无需打包构建,所以速度很快。
<script type="module"> import './main.js' </script>
// vue-dev-server/test/main.js import Vue from 'vue' import App from './test.vue' new Vue({ render: h => h(App) }).$mount('#app')
main.js 中的 import 语句 import Vue from 'vue' 通过 recast 生成 ast 转换成 import Vue from "/__modules/vue"
而最终返回给浏览器的是 vue-dev-server/node_modules/vue/dist/vue.esm.browser.js
main.js
中的引入 .vue
的文件,import App from './test.vue'
则用 @vue/component-compiler 转换成浏览器支持的文件。
读到这里,这篇“如何开发vue-dev-server”文章已经介绍完毕,想要掌握这篇文章的知识点还需要大家自己动手实践使用过才能领会,如果想了解更多相关内容的文章,欢迎关注亿速云行业资讯频道。
免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。