当vue-router遇到single-spa

1. 问题

使用window.history.pushState修改url(urlA --> urlB),但是之后url又莫名被改成了urlA

import qs from 'qs'

export function removeUrlQuery($vm: Vue, queryKey: string) {
  const newQuery: { [key: string]: string } = qs.parse(window.location.search.substr(1, window.location.search.length))
  delete newQuery[queryKey]
  window.history.pushState('', document.title, `${window.location.pathname}?${qs.stringify(newQuery)}`)
  $vm.$delete($vm.$route.query, queryKey)
}

2. 解决之道

通过debugger发现在经过 window.history.pushState方法后路由确实更新为urlB
因为涉及路由变化,我在router.beforeEach中打了断点,发现进到这里时,路由已经由urlB变回了urlA,到这儿我就束手无策了,接下来是请教了大佬之后学会的,一起来看看吧。

2.1. Call Stack

打断点的时候要会看调用栈,知道当前方法是谁触发的。


call stack

右边就是调用栈,可以挨个点进去看(这边忽略了一些文件)。
可以看到倒数第二行就是在开头提到的修改路由的方法removeUrlQuery,之后就由single-spa接管了,那这个single-spa是什么呢,正常路由变化不是应该直接由vue-router来触发beforeEach么。
点进去看一下,发现这个.min.js很难看明白,毕竟是压缩版的js,那如何能看到正常的js呢。

2.2. 打包的文件

我们在node_modules里面找到single-spa,先看package.json

{
  "name": "single-spa",
  "version": "5.9.3",
  "description": "The router for easy microfrontends",
  "main": "lib/umd/single-spa.min.js",
  "types": "typings/single-spa.d.ts",
  "module": "lib/esm/single-spa.min.js",
  "scripts": {
  ...

main字段配置了这个包的入口文件,不过这里还有一个module字段,定义了ESM规范的入口文件,它的优先级是比main高的,所以入口文件就是lib/esm/single-spa.min.js,那我们把这边改成
lib/esm/single-spa.dev.js,重启项目,再debugger一次。


single-spa.dev.js

这次就能看到熟悉的正常代码了。
看右边倒数第5行,这是执行过removeUrlQuery之后进入的代码,对应着左边914行,那么为什么会执行到这一行呢。
这个时候就得看看single-spa源码了,to the github~
找到这个版本的代码5.9.3,你可以git clone,也可以直接线上看。
在地址栏一级域名github后面加上1s,就可以在线VS Code打开代码。
全局搜索一下patchedUpdateState(上图903行这个方法)这个方法,可以看到,这个库重写了pushState和replaceState方法,所以我执行pushState,它会走到patchedUpdateState这个方法返回的函数(称这个函数为Fa)中。

patchedUpdateState

我在Fa中打了断点,发现整个过程执行了两次Fa,一次是urlA变为urlB,第二次是urlB变为urlA,第一次的methodName为pushState,第二次是replaceState。
这个pushState很显然是我通过removeUrlQuery触发的,那么第二次的replaceState是哪个小(tu)可(zai)爱(zi)触发的呢?我们再看一下第二次进入Fa时的调用栈,下上两个红线分别代表第一、二次进入Fa,我们来看看这个过程发生了什么。


replaceState

往前追溯时vue-router的pushState --> replaceState,啊找到了,点过去会看到他的入参是urlA。显然路由就是在这个pushState被改回了urlA。

function replaceState (url) {
  pushState(url, true);
}

再往前追溯,看这个ensureURL,这时就得看vue-router源码,还是老方法打开源码(版本要确认好) 。发现replaceState的参数来自于current,这个current是什么得看这个this

HTML5History.prototype.ensureURL = function ensureURL (push) {
  if (getLocation(this.base) !== this.current.fullPath) {
    var current = cleanPath(this.base + this.current.fullPath);
    push ? pushState(current) : replaceState(current);
  }
};

找到HTML5History,可以看到把History赋给了HTML5History的proto,HTML5History可以访问到History的属性、方法等,而History中的current是通过updateRoute方法进行赋值的,通过debugger发现在urlA变成urlB的过程中,并未调用updateRoute方法,即current一直是urlA状态,直到beforeEach结束后才进入updateRoute方法。

var HTML5History = /*@__PURE__*/(function (History) {
    ...    
    if ( History ) HTML5History.__proto__ = History;
    ...
    return HTML5History;
}(History)

History.prototype.updateRoute = function updateRoute(route) {
  this.current = route
  this.cb && this.cb(route)
}

继续看上图可以看到single-spa触发了vue-router的handleRoutingEvent方法,最终导致了pushState,那single-spa是如何触发handleRoutingEvent方法的呢
首先看vue-router代码会发现,它给popstate方法注册了handleRoutingEvent,而single-spa在callCapturedEventListeners中执行了popstate注册的所有方法,其中eventArguments[0]是addEventListener注册事件的参数,它的type就是监听的事件名称也就是popstate

// vue-router
window.addEventListener('popstate', handleRoutingEvent);
// single-spa
export function callCapturedEventListeners(eventArguments) {
  if (eventArguments) {
    const eventType = eventArguments[0].type;
    if (routingEventsListeningTo.indexOf(eventType) >= 0) {
      capturedEventListeners[eventType].forEach((listener) => {
        try {
          // The error thrown by application event listener should not break single-spa down.
          // Just like https://github.com/single-spa/single-spa/blob/85f5042dff960e40936f3a5069d56fc9477fac04/src/navigation/reroute.js#L140-L146 did
          listener.apply(this, eventArguments);
        } catch (e) {
          setTimeout(() => {
            throw e;
          });
        }
      });
    }
  }
}

那single-spa又是如何执行到callCapturedEventListeners的呢,上面讲过它代理了pushState方法,你调用pushState就会走进它的patchUpdateState方法,这个方法中通过window.dispatchEvent执行了一个自定义事件popstate,而window.addEventListener监听了popstate事件,执行urlReroute(在调用栈中也可以看到这个方法),一直执行到callCapturedEventListeners,urlReroute事件的参数也一直被传到callCapturedEventListeners中,下面代码可以看到urlReroute方法中,参数通过arguments形式传入reroute的,所以变成了数组,所以上面要用eventArguments[0]

window.dispatchEvent(createPopStateEvent(window.history.state, methodName))

function urlReroute() {
  reroute([], arguments);
}

function createPopStateEvent(state, originalMethodName) {
  let evt;
  try {
    evt = new PopStateEvent("popstate", { state });
  } catch (err) {
    evt = document.createEvent("PopStateEvent");
    evt.initPopStateEvent("popstate", false, false, state);
  }
  evt.singleSpa = true;
  evt.singleSpaTrigger = originalMethodName;
  return evt;
}

if (isInBrowser) {
  // We will trigger an app change for any routing events.
  window.addEventListener("hashchange", urlReroute);
  window.addEventListener("popstate", urlReroute);

至此,url改变的整条路就都找到啦。

3. 总结

简单总结一下

  • 控制台调用栈的使用
  • 修改包的入口文件
  • 阅读源码
  • 常用api熟悉(dispatchEvent、PopStateEvent、addEventListener)
  • this指向

如果这些都能够熟练掌握,相信下次debugger一定不会再束手无策啦

Z. 参考

package.json 中 你还不清楚的 browser,module,main 字段优先级
微前端 | 5. single-spa 的生命周期和事件管理

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,014评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,796评论 3 386
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,484评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,830评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,946评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,114评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,182评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,927评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,369评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,678评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,832评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,533评论 4 335
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,166评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,885评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,128评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,659评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,738评论 2 351

推荐阅读更多精彩内容