百度程序员开发避坑指南（前端篇）

日常工作开发中，遇到哪些坑是让你印象深刻且具有挑战的，它们是怎么产生的，我们该如何避免？本期我们带来与前端开发相关的三个问题：一次网页资源加载问题的定位过程；CSS中的z-index层叠覆盖问题；CSS3 transform 属性对 position 的影响，希望能为你的技术提升助力。

01

一次网页资源加载问题的定位过程

今天讨论的话题比较聚焦，就是有用户报Web页面资源或局部区域加载不出来的问题，该如何查？又该如何避免？

1.1 问题描述

用户反馈页面内的推荐列表加载不出来，而且能稳定复现。

1.2 分析

第一反应就是自己复现，但是不行啊，团队没有同学能复现，也无法接触到用户。那么先理清楚此区域的实现逻辑，该区域的HMTL虽然已经下载，但默认不可见，而是依赖c.js（文件名简化了）展现。基于此，我们怀疑：

• c.js 以及其依赖的a.js, b.js等 加载非常慢或直接失败；

• c.js 以及其依赖逻辑发生JS异常。

1.3 监控实现

那么该如何佐证，我们需要做下监控。

做监控需要考虑到实际场景，由于Head和Body都有外链请求，因此监控代码要置于顶部且内联，且代码要精简，从而可以最大程度拿到信息和减少首屏影响。

window.addEventListener('error', event => {
    if (event.srcElement !== window) {
        console.log('资源加载失败，加载资源的元素是：', event.srcElement);
        send();
  }
    else {
        console.log('JS报错：', event.message);
        send();
    }
}, true);

window.addEventListener('unhandledrejection', event => {
    const error = event.reason || {};
    console.log('JS报错：', error);
    send();
});

上述可以监控到全局的 资源加载失败 和 JS异常，包括未捕获的Promise Rejection。此外，还需定位资源，通过向上遍历获取元素的XPath，XPath上带上id或class属性，避免全都是`div>div>div>div`，而摸不着头脑。

上线后发现，有不少错误都是script error，这是因为外链JS都是CDN域名。浏览器对于脚本执行遵守 same-origin policy ，为避免域名信息泄漏给宿主域名，特意隐藏错误信息。

解决方案是给所有外链JS加上响应头。

access-control-allow-origin: *

JS资源若托管在云上CDN服务，那么其CDN控制台都会提供增加Header功能。

若是自有服务，就需要主动设置Header。这里假设使用Koa2 框架，设置如下：

ctx.set('Access-Control-Allow-Origin', '*');

然后给所有该CDN域名的script元素增加crossorigin属性，如：

<script src="https://cdn.a.com/static/a.js" crossorigin="anonymous"></script>

但发现其在Chrome浏览器是生效的，可以拿到真实错误堆栈。可惜，Safari浏览器不支持此机制，依然只能拿到script error。为了Safari拿到真实错误，外链需要是同域。因此有个办法是在www.a.com的Nginx做一层代理转发，即 https://www.a.com/static/a.js 转发到 https://cdn.a.com/static/a.js  。不过如此一来，就丧失CDN就近访问的优势，不适合常态化。但可以在定位用户问题时，将用户访问临时切换成 https://www.a.com/static/a.js。

那如何监控加载慢，可以在onload事件后获取慢资源。

const list = performance.getEntriesByType('resource');
const len = list.length;
const slowList = [];
for (let i = 0; i < len; i++) {
     const timing = list[i];
     // 大于1s
     if (timing.duration > 1000) {
         slowList.push(timing);
     }
}
send(slowList);

上报信息也包含了每个请求的TCP、下载等耗时，详细可见Resource_Timing_API规范（https://developer.mozilla.org/en-US/docs/Web/API/Resource_Timing_API/Using_the_Resource_Timing_API）。

要注意的是，该API信息受到CORS （https://developer.mozilla.org/en-US/docs/Glossary/CORS）影响，必须给资源设置如下响应头才能拿到数据，否则很多字段取值都是0。

Timing-Allow-Origin: *

通过分析这些数据，我们可以知道资源耗时过程，这里可以充分参照Chrome开发者工具提供的Timing子面板，了解关键时段耗时。比如同域名6个并发请求限制，若资源请求较多，则可能处于stalled（挂起等待）状态。这些阶段可能原因分析参考Chrome说明。



由于有些图片在页面内不好确定位置，因此需要获取其XPath，如何获取呢？对于img标签加载图片，可以快速获取：

// timing.name就是资源地址，适合
const img = document.body.querySelector('img[src="' + timing.name + '"]');
const xpath = getxpath(img);

额外信息获取，其实除了问题信息本身外，用户当时环境信息非常重要，如

1. performance.memory：获取内存使用信息；

2. navigator.connection：用户连接情况，可惜，此API不怎么准；

如果是APP内页面，可以调用端能力获取到用户网络类型、网速。

1.4 数据分析

上线后，用户依然访问慢。根据日志发现，用户未有JS报错，但根据慢资源日志，发现有大量资源加载超过1s，有些资源甚至达到10s，其花费在建连阶段耗时较大。看来问题还不是这么简单，那如何解释用户资源加载如此慢？用户所在局域网环境差？接入运营商质量差？插件影响？CDN问题？

这些问题只有CDN可以去排查，我们首先拿到用户访问 https://www.a.com 的服务器端日志，获取到用户IP。联合云CDN服务，根据用户IP，竟然未查到任何CDN访问日志。但从日志看，用户确实请求了大量JS，并不是全部本地缓存。所以用户IP可能不是访问CDN的IP，有一种情况是使用代理。

所以想通过其他信息捞取用户的CDN日志，来确定访问CDN的IP。思路是按照用户UA、请求地址等非精确信息捞取CDN日志，但由于捞取日志量非常大，无法确定哪些日志是该用户的；而：

1.CDN域名一般是无cookie域名，没有TRACEID；

2.Web页面无法给script/link资源请求头设置Traceid；

3.前端目前无法拿到CDN TCP建连IP；

综上，除了用户IP，种种精确定位信息都无效。因此这一步举步维艰。

好在能联系上用户，咨询是否使用代理，结果：确实使用了代理，且根据用户代理，实测代理非常慢，甚至加载超时，其代理请求走了香港服务器。通过代理出口IP，最终从海外CDN捞取到了用户访问日志。同时也确认，用户将所有 *.a.com 请求配置不使用代理，所以服务端能拿到的IP是用户IP，而CDN拿到的是代理出口IP。

1.5 总结

Web能力终是有限，但通过足够的辅助信息，以及全链路协作，在定位Case过程中也会事半功倍。该Case虽然归因于用户不合理代理配置，但也可基于此场景做技术优化。如任何首屏内容不依赖外链展现，减少核心逻辑JS体积，增加资源缓存率等。

02

CSS中的z-index层叠覆盖问题

2.1 含义

z-index属性指定了元素及其子元素的【z顺序】，而【z顺序】可以决定当元素发生覆盖的时候，哪个元素在上面。通常一个较大的z-index值的元素会覆盖较低的那一个。

属性指定两件事：

• 当前元素的堆叠顺序
• 当前元素是否建立新的堆叠上下文

2.2 属性值

• 默认值：z-index:auto;
• 整数值：z-index:<integer>;
• 继承：z-index:inherit;

2.3 基本特性

• 在CSS2.1时代，需要和定位元素配合使用；
• 如果定位元素z-index没有发生嵌套(并列的)：
• 后来者居上的准则；
• 哪个大哪个上（z-index大小比较）；
• 如果定位元素z-index发生嵌套：
• 祖先优先原则（前提：z-index是数值，不是auto）

以上为z-index的基本介绍。

当业务越来越复杂，多种弹窗、toast、浮层各种组件，多人协同业务开发的情况下：

• 老业务写了个z-index：5000；
• B同学调用一个全局弹层，原本设置为100，想要覆盖全局，z-index改为10000；
• C同学调用一个toast，原本设置为2000，想要覆盖弹层，z-index改为100000；
• ...
• 层层覆盖的情况下，不能无限改下去，为了避免这样的情况发生，减少不断覆盖的情况，那么应该如何规定z-index的值呢；

const KEY = '_tbv_z_index_';

function initZIndex$() {
    return (window[KEY] = 10000);
}

// 初始化，只能被调用一次
function once(fn) {
    const flag = true;

    return function () {
        if (flag) {
            flag = false;
            const args = Array.prototype.slice.call(arguments, 0);
            fn.apply(args);
        }
    };
}
const initZIndex = once(initZIndex$);

// 外部调用&支持重置
function zIndex$(zIndex) {
    if (zIndex) {
        return (window[KEY] = zIndex);
    }

    return (window[KEY] += 1);
}

// 组件mount时触发+1
const zIndex = zIndex$();

注意：还是要规范z-index的配置，不要乱用滥用随意赋值，根据依赖规则合理使用；

03

CSS3 transform 属性对 position 的影响

CSS3中引入了transform，定义了在二维或三维空间中元素的旋转、缩放、平移等行为，还能利用合成层原理开启GPU加速，提升页面动画的流畅度。然而transform也不是「省油的灯」（并没有说它不好的意思，我就很喜欢它），增强了页面交互效果的同时它也有一些「副作用」容易让人踩坑。

position: fixed 实现了固定定位的效果，元素不追随滚动条进行滚动，普通元素的overflow属性也无法对其进行裁剪，因此在一些需要固定头部、固定悬浮按钮的场景中十分好用。

但fixed遇上transform时表现的就不再那么「强硬」，反而退化成了position: absolute的效果。在外层没有transform影响时，固定定位元素的包含块是根元素，可以近似认为是<html>元素，因此fixed元素可以实现相对视口定位的效果。而当元素设置了transform时，便会创建一个新的包含块(containing block)，如果该元素的内部有元素设置了fixed定位，那么该fixed元素的包含块便不再是根元素，而变成了被设置了transform的元素。如果在开发过程中发现设置了position:fixed的元素随着页面滚动了，就可以看下fixed的元素外层是否有元素设置了transfrom。

除了包含块之外，transform还会生成新的层叠上下文（stack context）,使得元素内部和外部的z-index相互独立，出现低z-index元素层级比高z-index元素还高的情况：

推荐阅读：

一键三连，好运连连，bug不见👇