前言
导致白屏的原因大概有两种，一为资源的加载，二为 JS 执行出错
本文就 JS 中执行的报错，会比较容易造成"白屏"场景，和能解决这些问题的一些方法，作出一个汇总
常见的错误
SyntaxError
SyntaxError（语法错误）对象代表尝试解析不符合语法的代码的错误。当 Javascript 引擎解析代码时，遇到了不符合语法规范的标记（token）或标记顺序，则会抛出SyntaxError。
这里陈列下 SyntaxError 的常见错误
保留字错误
SyntaxError: "x" is a reserved identifier (Firefox)SyntaxError: Unexpected reserved word (Chrome)
如在控制台执行下方代码，则会上述错误出现
const enum = 1enum 在严格模式和非严格模式下都是保留字。
而以下标记符只会在严格模式下才作为保留字：
implementsinterfaceletpackageprivateprotectedpublicstatic
例如:
const implements = 1 // ✅
"use strict";
const implements = 1; // caught SyntaxError: Unexpected strict mode reserved word"use strict";
const implements = 1; // caught SyntaxError: Unexpected strict mode reserved word
命名错误
一个 JavaScript 标识符必须以字母开头，下划线（_）或美元符号（$）。他们不能以数字开头。只有后续字符可以是数字（0-9）。
var 1life = 'foo';
// SyntaxError: identifier starts immediately after numeric literal
var foo = 1life;
// SyntaxError: identifier starts immediately after numeric literalvar foo = 1life;
// SyntaxError: identifier starts immediately after numeric literal
错误的标点
在代码中有非法的或者不期望出现的标记符号出现在不该出现的位置。
“This looks like a string”;
// SyntaxError: illegal character
42 – 13;
// SyntaxError: illegal character42 – 13;
// SyntaxError: illegal character
代码里使用了中文的引号和横杠，造成了解析错误，这里就体现了编辑器的重要性
JSON 解析
JSON.parse('[1, 2, 3, 4, ]');
JSON.parse('{"foo" : 1, }');
// SyntaxError JSON.parse: unexpected character
// at line 1 column 14 of the JSON datajson 解析失败的类型有很多，这里就不赘述了，我们在进行 json 解析的时候，一定要加上 try...catch 语句来避免错误
分号问题
通常情况下，这个错误只是另一个错误一个导致的，如不正确转义字符串，使用 var 的错误
const foo = 'Tom's bar';
// SyntaxError: missing ; before statement通过其他方案声明:
var foo = "Tom's bar";
var foo = 'Tom's bar';
var foo = Tom's bar; // 推荐这种方案使用 var 错误
var array = [];
var array[0] = "there"; // SyntaxError missing ; before 类似当前错误的还有很多，比如:
SyntaxError: missing ) after argument listSyntaxError: missing ) after conditionSyntaxError: missing } after function bodySyntaxError: missing } after property list
这些都是语法的错误，在编辑器/IDE使用时期都能解析，但是在某些比较古老的框架下，
编辑器可能并不能识别出来他的语法，这便是此错误经常出现的场景
小结
SyntaxError 属于运行时代码错误，通常也是新手开发者容易犯得的错误 ，在 dev 时期就可以发现，不然无法通过编译，是属于比较容易发现的问题
TypeError
TypeError（类型错误）对象通常（但并不只是）用来表示值的类型非预期类型时发生的错误。以下情况会抛出 TypeError：
- 传递给运算符的操作数或传递给函数的参数与预期的类型不兼容；
- 尝试修改无法更改的值；
- 尝试以不适当的方法使用一个值。
不可迭代属性
当使用 for...of ，右侧的值不是一个可迭代值时，或者作为数组解构赋值时，会报此问题
例如:
const myobj = { arrayOrObjProp1: {}, arrayOrObjProp2: [42] };
const {
arrayOrObjProp1: [value1],
arrayOrObjProp2: [value2],
} = myobj; // TypeError: object is not iterable
const obj = { France: "Paris", England: "London" };
for (const p of obj) {
// …
} // TypeError: obj is not iterable</code></pre><p>JS 中有内置的可迭代对象，如: <code>String</code>、<code>Array</code>、<code>TypedArray</code>、<code>Map</code>、<code>Set</code> 以及 <code>Intl.Segments (en-US)</code>，因为它们的每个 <code>prototype</code> 对象都实现了 <code>@@iterator</code> 方法。</p><p><code>Object</code> 是不可迭代的，除非它们实现了迭代协议。</p><p>简单来说，对象中缺少一个可迭代属性: <code>next</code> 函数</p><p>将上述 <code>obj</code> 改造:</p><pre><code class="js">const obj = {
France: "Paris", England: "London",
[Symbol.iterator]() {
// 用原生的空数组迭代器来兼容
return [][Symbol.iterator]();
},
};
for (const p of obj) {
// …
}</code></pre><p>如此可不报错，但是也不会进入循环中</p><p><a target="_blank" href="https://link.segmentfault.com/?enc=EqNqz5cHPFNX9DPC8bNbzQ%3D%3D.OkpaWANGxWyqaxcL93sWgMW%2BO6ebtuiPM3MjR708L8eV9Xuc2aS5Tp6nioTwL%2BE6QN%2BMF4WxlI034%2FETtpdwxHg5GhwvwOBhWcH%2FmwX%2B8CBMz%2Fm7zKb4UIXv%2BGxoHHexuhMdaGcOdSIrAOH0mff%2FXQ%3D%3D">点此查看什么是迭代协议</a></p><h4>空值问题</h4><pre><code class="js">null.foo;
// 错误类型：null 没有这个属性
undefined.bar;
// 错误类型：undefined 没有这个属性
const foo = undefined;
foo.substring(1); // TypeError: foo is undefined</code></pre><p>虽然看起来简单，但是他是出现白屏最为频繁的报错原因之一</p><p>在以前我们通常这样解决问题:</p><pre><code class="js">var value = null;
value && value.foo;</code></pre><p>现在我们可以使用 <strong>可选链</strong> <a target="_blank" href="https://link.segmentfault.com/?enc=mk7PjC8IRcEv64K9LaB%2BIg%3D%3D.%2BS11nf%2FgKSxsY22lns9h9jxvXA6yuIFpfzQjqACY%2Bq6WOkWSNmtIB4i882VW6wXDYg6lmNo484PuZ%2F0ylB1Ly4Gz9x84siwpDBDylez3q%2BY%2F9dlmlsQUiKttjjvXVMrq">Optional chaining</a> 来解决这个问题</p><pre><code class="js">var value = null;
value?.foo;
// 但是他也不能用来赋值:
value?.foo = 1</code></pre><p>可选链语法:</p><pre><code class="js">obj.val?.prop
obj.val?.[expr]
obj.func?.(args)</code></pre><h4>错误的函数执行</h4><p>错误的函数名称:</p><pre><code class="js">var x = document.getElementByID("foo");
// TypeError: document.getElementByID is not a function
var x = document.getElementById("foo"); // 正确的函数</code></pre><hr><p>不存在的函数:</p><pre><code class="js">var obj = { a: 13, b: 37, c: 42 };
obj.map(function(num) {
return num * 2;
});
// TypeError: obj.map is not a function</code></pre><h4><code>in</code> 的错误场景</h4><p>在判断一个对象中是否存在某个值时，比较常用的是一种方法是使用 <code>in</code> 来判断:</p><pre><code class="js">var foo = { baz: "bar" };
if('baz' in foo){
// operation
}</code></pre><p>因为不能确定 foo['baz'] 的具体值，所以这种方案也是不错的，但是当 <code>foo</code> 的类型也不能确认的时候就会容易出现报错了</p><pre><code class="js">var foo = null;
"bar" in foo;
// TypeError: invalid 'in' operand "foo"
"Hello" in "Hello World";
// TypeError: invalid 'in' operand "Hello World"</code></pre><p>字符串和空值不适合使用此语法</p><p>_另外需要注意的是_，在<strong>数组</strong>中需要小心使用</p><pre><code class="js">const number = [2, 3, 4, 5];
3 in number // 返回 true.
2 in number // 返回 true.
5 in number // 返回 false，因为 5 不是数组上现有的索引，而是一个值;</code></pre><h4>小结</h4><p>因为错误是跟随着不同的值类型，而数据的接收/转变我们并不能做到 100% 的把控。<br>它是我们平时线上报错最频繁的一种类型，也是最容易造成页面白屏的。需要保持 120% 的小心。</p><h3 id="item-0-5">RangeError</h3><blockquote><strong><code>RangeError</code></strong> 对象表示一个特定值不在所允许的范围或者集合中的错误。</blockquote><p>在以下的情况中，可能会遇到这个问题：</p><ul><li>将不允许的字符串值传递给 <a target="_blank" href="/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String/normalize"><code>String.prototype.normalize()</code></a>，或</li><li>尝试使用 <a target="_blank" href="/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array"><code>Array</code></a> 构造函数创建一个具有不合法的长度的字符串，或</li><li>传递错误值到数值计算方法（<a target="_blank" href="/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Number/toExponential"><code>Number.toExponential()</code></a>、<a target="_blank" href="/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Number/toFixed"><code>Number.toFixed()</code></a> 或 <a target="_blank" href="/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Number/toPrecision"><code>Number.toPrecision()</code></a>）。</li></ul><p>这里举几个例子:</p><pre><code class="js">String.fromCodePoint("_"); // RangeError
new Array(-1); // RangeError
new Date("2014-25-23").toISOString(); // RangeError
(2.34).toFixed(-100); // RangeError
(42).toString(1);
const b = BigInt(NaN);
// RangeError: NaN cannot be converted to a BigInt because it is not an integer</code></pre><hr><p>总的来说 RangeError 都是因为传入了不正确的值而导致的，这种情况发生的概率较小，部分数字都是自己可以手动控制或者写死在代码里的 <br>除非是定制化很高的情况，比如低代码，让用户随意输入的时候，在使用的时候，最好先做出判断，或者加上 <code>try...catch</code></p><h3 id="item-0-6">ReferenceError</h3><blockquote><strong><code>ReferenceError</code></strong>（引用错误）对象代表当一个不存在（或尚未初始化）的变量被引用时发生的错误。</blockquote><p>这种报错的场景大多处于严格模式下，在正常情况下 <strong>"变量未定义"</strong> 这种报错出现的情况较多</p><pre><code class="js">foo.substring(1); // ReferenceError: foo is not defined</code></pre><p>如上，<code>foo</code> 未定义即直接使用，则就会出现报错</p><p>还有一类报错是赋值的问题，比如上方讲过的<strong><em>可选链</em></strong>功能，他是不能赋值的:</p><pre><code class="js">foo?.bar = 123</code></pre><p>这一类在编码因为容易分析，一般在编辑器中就能容易发现，所以并不会带来很多困扰。</p><h3 id="item-0-7">其他</h3><p><strong><code>InternalError</code> 对象</strong>表示出现在 JavaScript 引擎内部的错误。尚未成为任何规范的一部分，所以我们可以忽略。</p><hr><p><strong><code>EvalError</code></strong> 代表了一个关于 <code>eval()</code> 全局函数的错误。</p><p>他不在当前的 <code>ECMAScript</code> 规范中使用，因此不会被运行时抛出。但是对象本身仍然与规范的早期版本向后兼容。</p><hr><p><strong><code>URIError</code></strong> 对象用来表示以一种错误的方式使用全局 URI 处理函数而产生的错误。</p><p>例如:</p><pre><code class="js">decodeURIComponent('%')
// caught URIError: URI malformed
decodeURI("%")
// Uncaught URIError: URI malformed at decodeURI</code></pre><p>所以使用 <code>decodeURIComponent</code> 函数时，需要加上 <code>try...catch</code> 来保持正确性</p><h2 id="item-0-8">另类错误</h2><h3 id="item-0-9">unhandledrejection</h3><p>当 <a target="_blank" href="/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise"><code>Promise</code></a> 被 reject 且没有 reject 处理器的时候，会触发 <strong><code>unhandledrejection</code></strong> 事件；<br>这个时候，就会报一个错误：<code>unhanled rejection；</code>没有堆栈信息，只能依靠行为轨迹来定位错误发生的时机。</p><pre><code class="js">window.addEventListener('unhandledrejection', event =>
{
console.log('unhandledrejection: ', event.reason); // 打印
});
let p = Promise.reject("oops");
// 打印 unhandledrejection: oops
// caught (in promise) oops</code></pre><h3 id="item-0-10">手动抛出错误</h3><p>我们在书第三方库的时候，可以手动抛出错误。但是throw error会阻断程序运行，请谨慎使用。</p><pre><code class="js">throw new Error("出错了！"); // caught Error: 出错了！
throw new RangeError("出错了，变量超出有效范围！");
throw new TypeError("出错了，变量类型无效！");</code></pre><p>同样的，此种方案我们可以使用在 <code>Promise</code> 的 <code>then</code> 中:</p><pre><code class="js">// 模拟一个接口的返回
Promise.resolve({code: 3000, message: '这是一个报错！'}).then(res => {
if (res.code !== 200) {
throw new Error(`code 3000: ${res.message}`)
}
console.log(res); // 这里可以看做是执行正常操作, 抛出错误时, 此处就不会执行了
}).catch(err => {
alert(err.message)
});</code></pre><p>在 <code>catch</code> 中我们可以通过 <code>name</code> 来判断不同的 <code>Error</code>:</p><pre><code class="js">try {
throw new TypeError(`This is an Error`)
} catch (e) {
console.log(e.name); // TypeError
}</code></pre><p>再加上自定义的 <code>Error</code>，我们就可以制作更加自由的报错信息:</p><pre><code class="js">class ValidationError extends Error {
constructor(message) {
super(message);
this.name = "ValidationError";
}
}
try {
throw new ValidationError(`This is an Error`)
} catch (e) {
console.log(e.name);
// 'ValidationError'
if (e instanceof ValidationError) {
alert("Invalid data: " + e.message); // Invalid data: This is an Error
}
}</code></pre><p>在 <code>Error</code> 的基础上我们还可以做更深入的继承，来制作更多的自定义 <code>Error</code></p><h2 id="item-0-11">报错在 react 中的影响</h2><p><code>react</code> 报错按照位置，我将他分成两类，一类是<strong>渲染报错</strong>，另一类是<strong>执行报错</strong>; <br>渲染即 <code>render</code> 函数中的视图渲染报错，另一个则是执行函数报错;</p><p>函数的执行报错，是不会影响视图的渲染的，即<strong>白屏</strong>，但是他会有一些不良影响，如</p><ul><li>代码执行暂停，部分逻辑未执行，未能闭环整体逻辑，如点击按钮一直卡在 <code>loading</code> 中</li><li>数据的渲染出现异常，两边数据对不上</li></ul><hr><p>在视图渲染中(包括函数的 <code>return</code>) ，触发 JS 错误，都会渲染问题</p><p><em>那为什么整个页面都会白屏呢 ?</em></p><p>原因是自 <code>React 16</code> 起，任何未被<strong>错误边界</strong>捕获的错误将会导致整个 <code>React</code> 组件树被卸载。</p><h3 id="item-0-12">错误边界</h3><p>在 react 中存在此生命周期 <code>componentDidCatch</code>，他会在一个子组件抛出错误后被调用。</p><pre><code class="js">class ErrorBoundary extends React.Component {
constructor(props) {
super(props);
this.state = { hasError: false };
}
// 最新的官方推荐, 通过此 api 获取是否触发错误
static getDerivedStateFromError(error) {
return { hasError: true };
}
// 旧方案是在此处 setState
componentDidCatch(error, info) {
// Example "componentStack":
// in ComponentThatThrows (created by App)
// in ErrorBoundary (created by App)
// in div (created by App)
// in App
logComponentStackToMyService(info.componentStack);
}
render() {
if (this.state.hasError) {
return <h1>Something went wrong.</h1>;
}
return this.props.children;
}
}</code></pre><pre><code><ErrorBoundary fallback={<p>Something went wrong</p>}>
<Profile />
</ErrorBoundary></code></pre><p>这是来自官网的一个简单例子，可以覆盖子组件出错的情况，避免本身组件或兄弟组件收到波及，而错误边界组件的<strong>粒度</strong>需要开发者本身来界定</p><h3 id="item-0-13">降级和熔断</h3><p>在官方的文档中他更加推荐此组件 <a target="_blank" href="https://link.segmentfault.com/?enc=RqzfyvEEcWdUb9DOl7Ckyw%3D%3D.zWk2RDWiiFeI5fiNd1n85%2Fa3STCetZM5UcFZaWO%2FTTWAPBle%2B1dbfBd4WDGIBcBw">react-error-boundary</a>，它有着更加丰富的使用:</p><p>他可以简单的显示错误:</p><pre><code>function Fallback({ error }) {
return (
<div role="alert">
<p>Something went wrong:</p>
<pre style={{ color: "red" }}>{error.message}</pre>
</div>
);
}
<ErrorBoundary
FallbackComponent={Fallback}
>
<ExampleApplication />
</ErrorBoundary>;</code></pre><p></p><p>也可以使用<em>重置</em>方案:</p><pre><code class="js">function Fallback({ error, resetErrorBoundary }) {
return (
<div role="alert">
<p>Something went wrong:</p>
<pre style={{ color: "red" }}>{error.message}</pre>
<button onclick={resetErrorBoundary}></button>
</div>
);
}</code></pre><p></p><p>通过此方法重置组件，避免了刷新页面，对于用户来说更加友好</p><blockquote>更多使用，可以查看<a target="_blank" href="https://link.segmentfault.com/?enc=%2FsyHxuQexIOtKhhVQGYFgg%3D%3D.UPW%2BVxo%2FtQT6TMxGtEdjgtNeroYVnL8soSnHgE%2BMxoX6PeJHyVdaEyJOhDmuSITFc7VFw4DgqzMSZQTPRx4KW5fJ5TPsQkQtalObcmanhEo%3D">此处博客</a></blockquote><h2 id="item-0-14">总结</h2><p>JS中有很多报错，但是编辑器/编译，已经帮助我们过滤了一大部分的错误，但是仍然会有部分报错会在特殊条件下出现 <br>所以一方面需要充分的测试，如最大值/最小值/特殊值等等，另一方面就是需要积累经验，一些写法就是容易出现问题，可以通过 <code>codeReview</code> 来预防部分问题 <br>但最终要坚守软件开发的 <strong>不信任原则</strong>，保持 <code>overly pessimistic</code> （过于悲观），把和程序有关的一切请求、服务、接口、返回值、机器、框架、中间件等等都当做不可信的，步步为营、处处设防。</p><h2 id="item-0-15">引用</h2><ul><li><a target="_blank" href="https://link.segmentfault.com/?enc=ewWhPP226QAnrsJC9203Ow%3D%3D.Ncg8jgPnYs9Gi5xK7eZDuccyQjPOsoODY%2B8ANMBtR5nkGVK4MEbeqA1wLdhGQhVOiPz3%2BBThZPB8NJYNYbW2G8bwwZsqqtfv%2Fn3MbrC6eRM%3D">https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Refer...</a></li><li><a target="_blank" href="https://link.segmentfault.com/?enc=3FhlkLRK6pGfC2oODKSRsA%3D%3D.mf%2Bvmo7ri6pr%2BcFm8aCdcHyV7zHotBOeCIauxgilQU5johvAmCpa5RluGIoRBB4F">https://zhuanlan.zhihu.com/p/602293047</a></li><li><a target="_blank" href="https://link.segmentfault.com/?enc=egiNM4gcqxLHRN%2BCbcLQsg%3D%3D.uIQMjgdjoVbSfR0kBy9gbPQbQtEkRhbQp1BHXi0Iid2tkrZFMOsLDUCHIJpwUhtLQKh%2F98K5fQVFRdeImpifow%3D%3D">https://baobangdong.cn/the-story-about-blank-screen/</a></li></ul>
