history路由
history
模式是指使用HTML5的historyAPI
實(shí)現(xiàn)客戶端路由的模式次兆,它的典型表現(xiàn)就是去除了hash
模式中url路徑中的#
祭玉。對(duì)于前端路由基本原理還不了解的讀者可以看這篇博文【javascript基礎(chǔ)修煉(6)——前端路由的基本原理】。在使用Vue-Router
時(shí)開啟history
模式非常容易钧萍,只需要在實(shí)例化路由時(shí)傳入mode:'history'
配置項(xiàng)即可褐缠,但缺少服務(wù)端支持時(shí),基于historyAPI
的路由無法從url地址欄直接訪問指定頁面风瘦,這個(gè)很容易理解队魏,因?yàn)閡rl地址欄里輸入后回車相當(dāng)于發(fā)送了一次GET
請求,那么不帶#
的路由路徑就和普通的API
接口是一樣的万搔,既然服務(wù)端并沒有定義這樣的接口胡桨,那直接訪問時(shí)出現(xiàn)404頁面就很正常了。
官方示例
官方提供了很多處理這種場景的方式瞬雹,以node.js版本的處理方案為例:
const http = require("http");
const fs = require("fs");
const httpPort = 80;
http
.createServer((req, res) => {
fs.readFile("index.htm", "utf-8", (err, content) => {
if (err) {
console.log('We cannot open "index.htm" file.');
}
res.writeHead(200, {
"Content-Type": "text/html; charset=utf-8"
});
res.end(content);
});
})
.listen(httpPort, () => {
console.log("Server listening on: http://localhost:%s", httpPort);
});
不難看出昧谊,它的處理思路就是所有請求都強(qiáng)制重定向到首頁,相當(dāng)于服務(wù)端屏蔽了訪問資源不存在的情況酗捌,而將路由的工作留給客戶端自己去處理呢诬,這樣啟用了history
模式的前端路由在直接定位到子頁面時(shí)就不會(huì)報(bào)錯(cuò)了涌哲。
Express中間件
express
工程中使用connect-history-api-fallback中間件來處理后端路由的場景,它的使用方式非常簡單:
var history = require('connect-history-api-fallback');
var express = require('express');
var app = express();
app.use(history());
碼也只有120行(地址:connect-history-api-fallback中間件源碼 )尚镰,很容易閱讀阀圾,基本邏輯是只將滿足一些特定條件的請求進(jìn)行重定向,也就是將路由請求和API
請求區(qū)分開狗唉,重定向的規(guī)則可以自定義初烘,路由請求的判斷條件包括:
-
GET
請求 - headers.accept為
text/html
或*/*
(設(shè)置為application/json
或非字符串時(shí)會(huì)記錄錯(cuò)誤日志);
核心邏輯就是82-85行的:
rewriteTarget = options.index || "/index.html";
logger("Rewriting", req.method, req.url, "to", rewriteTarget);
req.url = rewriteTarget;
next();
也就是如果匹配到自定義的重定向規(guī)則就使用自定義場景,否則就使用/index.html
作為默認(rèn)值分俯,然后重寫req.url
屬性肾筐,接著進(jìn)入下一個(gè)中間件執(zhí)行其他邏輯。
客戶端兜底404
當(dāng)服務(wù)端重定向后缸剪,如果沒有進(jìn)行SSR
的同構(gòu)路由定制吗铐,對(duì)于所有路由請求都會(huì)返回index.html
頁面,此時(shí)如果需要使用404頁面橄登,就需要在客戶端路由中設(shè)定一個(gè)優(yōu)先級(jí)最低的兜底路由抓歼,由于優(yōu)先級(jí)的緣故,它不會(huì)影響其他精確匹配的路由配置:
const router = new VueRouter({
mode: 'history',
routes: [
{ path: '*', component: NotFoundComponent }
]
})
hash 和 history 對(duì)比
對(duì)比 | hash路由 | History API 路由 |
---|---|---|
url字符串 | 丑 | 正常 |
命名限制 | 通常只能在同一個(gè)document 下進(jìn)行改變 |
url地址可以自己來定義拢锹,只要是同一個(gè)域名下都可以谣妻,自由度更大 |
url地址變更 | 會(huì)改變 | 可以改變,也可以不改變 |
狀態(tài)保存 | 無內(nèi)置方法卒稳,需要另行保存頁面的狀態(tài)信息 | 將頁面信息壓入歷史棧時(shí)可以附帶自定義的信息 |
參數(shù)傳遞能力 | 受到url總長度的限制蹋半, | 將頁面信息壓入歷史棧時(shí)可以附帶自定義的信息 |
實(shí)用性 | 可直接使用 | 通常服務(wù)端需要修改代碼以配合實(shí)現(xiàn) |
兼容性 | IE8以上 | IE10以上 |