CHEATSHEET / 速查手册
需要的时候,翻一页就好
把常用 API 与易错规则压缩成可搜索的卡片。每条只保留签名、行为与坑点,适合写代码时快速对照; 系统学习仍建议回到对应章节,把来龙去脉读完整。
共 0 条
没有找到匹配条目。试试更短的关键字,例如 slice、Promise 或 事件。
基础语法与类型
声明、比较、字符串、数字与正则:日常写得最多,也最容易在细节上出错。
变量与类型
let块级作用域,可重新赋值;声明前访问会触发暂时性死区const块级作用域,必须初始化;绑定不可改,对象内容仍可修改var函数作用域,变量提升为 undefined;新代码不建议使用typeof返回类型字符串;typeof null 为 'object',typeof 函数为 'function'null表示空值,需要显式赋值;与 undefined 语义不同undefined变量未初始化、函数无返回值时的默认值NaN非数字,唯一不等于自身的值;Object.is(NaN, NaN) 为 trueNumber.isNaN()只在参数确实是 NaN 时返回 true,不做类型转换Number.isInteger()判断是否为整数;3.0 也返回 trueArray.isArray()可靠判断数组,跨 iframe 也有效Object.prototype.toString.call()精确类型判断,如得到 '[object Date]'Symbol唯一的原始值,常用作对象键,避免命名冲突BigInt任意精度整数,字面量加 n;不能与 Number 直接混合运算
运算符与比较
===严格相等:类型与值都相同才为 true==宽松相等:先做类型转换,容易踩坑,只建议用于判 null 或 undefinedObject.is()与 === 基本一致,但 NaN 相等、+0 与 -0 不相等??空值合并:只有左侧为 null 或 undefined 才取右侧||逻辑或:左侧为任意假值(0、空串、false)就取右侧?.可选链:左侧为 null 或 undefined 时短路,返回 undefined!逻辑非:先转布尔再取反;!!x 可把值转成布尔??=逻辑空赋值:左侧为 null 或 undefined 时才赋值||=逻辑或赋值:左侧为假值时才赋值&&=逻辑与赋值:左侧为真值时才赋值**幂运算,右结合:2 ** 3 ** 2 等于 512in判断属性是否存在,包含原型链instanceof判断构造函数的 prototype 是否在对象的原型链上delete删除对象自有属性,返回布尔;不能删除变量声明
字符串常用
str.lengthUTF-16 码元数量;一个 emoji 往往算 2slice(start, end)截取子串,支持负索引,返回新字符串substring(start, end)负值按 0 处理,并会自动交换两个参数indexOf()返回子串位置,找不到为 -1;lastIndexOf 从后往前找includes()是否包含子串,返回布尔值startsWith()判断前缀;endsWith 判断后缀padStart(len, str)在开头补足到指定长度;padEnd 在结尾补repeat(n)重复 n 次,n 必须是非负整数replace()替换第一个匹配,支持字符串或正则replaceAll()替换全部匹配,字符串参数也生效(ES2021)split()按分隔符拆成数组,分隔符可为字符串或正则trim()去除首尾空白;trimStart / trimEnd 只去一侧at(index)支持负索引,str.at(-1) 取最后一个字符
数字与格式化
Number(str)严格转换;空串为 0,含非法字符返回 NaNparseInt(str, radix)从头解析整数,始终显式传入基数parseFloat(str)解析浮点数,遇到非法字符停止Number.isFinite()仅当值是有限数字时为 true,不做类型转换toFixed(n)保留 n 位小数,返回字符串;存在浮点误差toPrecision(n)按有效数字位数返回字符串Math.round()四舍五入,恰好 .5 时向正无穷方向取整Math.trunc()直接截断小数部分,不四舍五入Math.max()求最大值;空参数返回 -Infinity,Math.min 相反Math.random()返回 [0, 1) 的伪随机数,不适合加密场景Intl.NumberFormat本地化千分位、货币与百分比格式Number.MAX_SAFE_INTEGER可安全表示的最大整数,即 2^53 - 1
正则常用
/pattern/flags字面量写法;动态拼接用 new RegExp()g / i / m全局、忽略大小写、多行模式s / u / y点号匹配换行、Unicode 模式、粘性匹配test()是否匹配,返回布尔值exec()返回匹配数组与 index;带 g 时依赖 lastIndexmatch()字符串方法;带 g 返回全部匹配,不带 g 返回捕获组信息matchAll()返回所有匹配的迭代器,正则必须带 greplace()支持 $1 与函数替换,可拿到捕获组split()用正则分割字符串,分隔符不会出现在结果里\d \w \s数字、单词字符、空白;大写形式取反^ $字符串开头与结尾;多行模式下匹配每行* + ?0 次以上、1 次以上、0 或 1 次{n,m}重复次数范围;省略 m 表示至少 n 次(?:…)非捕获分组;(?<name>…) 是命名分组
宽松相等的结果速查
下表全部使用 ==,最后两行使用 Object.is 作为对照。实际项目优先使用严格相等。
| 表达式 | 结果 | 原因 |
|---|---|---|
1 == '1' | true | 字符串转换为数字 |
0 == false | true | 布尔值转换为数字 |
null == undefined | true | 规范规定的特例 |
null === undefined | false | 类型不同 |
NaN == NaN | false | NaN 不等于自身 |
[] == false | true | 空数组转为原始值空串,再转为 0 |
'0' == false | true | 两边都转换为 0 |
Object.is(NaN, NaN) | true | Object.is 的特例 |
Object.is(0, -0) | false | 区分正零与负零 |
数据与函数
数组、对象、函数与高阶遍历:把数据变换写清楚,代码就自然短下来。
数组常用方法
push() / pop()尾部增删,改变原数组;pop 返回被删元素unshift() / shift()头部增删,改变原数组slice(start, end)截取子数组,不改变原数组splice(start, count)增删改,改变原数组,返回被删元素数组concat()合并数组,返回新数组,不改变原数组join(sep)拼接为字符串,默认用逗号分隔indexOf()查找索引,找不到为 -1;NaN 永远找不到includes()是否包含某个值,能正确判断 NaNreverse()原地反转,改变原数组sort(fn)原地排序,默认按字符串比较;数字要传比较函数flat(depth)拍平嵌套数组,默认深度为 1flatMap(fn)先 map 再 flat(1),适合一对多映射at(index)支持负索引,arr.at(-1) 取最后一项Array.from()类数组或可迭代对象转数组,可附带映射函数
对象与拷贝
Object.keys()返回自有可枚举属性名;values / entries 对应值与键值对Object.assign()浅拷贝或合并,返回目标对象,会修改目标{ ...obj }对象展开浅拷贝,后面的属性覆盖前面的Object.freeze()浅冻结,不能增删改自有属性,嵌套对象不受保护Object.isFrozen()判断对象是否被冻结Object.create(proto)以指定原型创建对象,可传 null 创建无原型对象Object.getPrototypeOf()读取对象的原型,替代已废弃的 __proto__Object.hasOwn()判断是否为自有属性,替代 hasOwnProperty.callin属性存在性检查,会沿原型链查找delete obj.key删除自有属性;严格模式下删除不可配置属性会报错structuredClone()结构化深拷贝,支持 Map、Set、Date,不能克隆函数JSON.parse(JSON.stringify())简易深拷贝;会丢失 undefined、函数与 Symbol,Date 会变字符串Object.fromEntries()键值对数组转对象,与 Object.entries 互逆
函数与箭头函数
function f() {}函数声明会提升,可在定义之前调用const f = function () {}函数表达式不提升,按赋值顺序使用const f = () => {}箭头函数,没有自己的 thisthis箭头函数继承外层 this;普通函数由调用方式决定new箭头函数不能 new,也没有 argumentsfunction f(a = 1)默认参数只在实参为 undefined 时生效(...args) => {}剩余参数,得到真正的数组arguments普通函数内的类数组对象,箭头函数中没有闭包函数记住定义时的词法环境,可保存私有状态高阶函数接收函数或返回函数,是 map、filter、compose 的基础call() / apply()立即调用并指定 this;apply 的第二个参数是数组bind()返回绑定了 this 的新函数,不立即调用纯函数相同输入得到相同输出,且没有副作用
数组高阶速查
map(fn)映射,返回等长新数组,不改变原数组filter(fn)过滤,返回满足条件的元素组成的新数组reduce(fn, init)归约;不传初始值时首项作为初值reduceRight()从右向左归约,适合右结合运算forEach(fn)遍历,返回 undefined,不能链式调用some(fn)任一满足即返回 true,命中后短路every(fn)全部满足才返回 true,不满足即短路find(fn)返回第一个满足条件的元素,否则 undefinedfindIndex(fn)返回索引,找不到为 -1findLast()从后往前查找(ES2023),findLastIndex 返回索引sort((a, b) => a - b)数字升序;不传函数会按字符串排序toSorted()返回排序后的新数组,不改变原数组(ES2023)
异步与运行时
Promise、事件循环与错误处理:搞清楚回调什么时候执行,比记住 API 更重要。
Promise 与异步
new Promise()接收执行器,执行器同步执行,状态只能改变一次then()注册兑现或拒绝回调,返回新的 Promisecatch()捕获拒绝,等价于 then(undefined, fn)finally()无论兑现或拒绝都执行,不改变结果Promise.resolve()包装为已兑现的 Promise,可用于统一返回值Promise.reject()创建已拒绝的 PromisePromise.all()全部成功才成功,任一失败立即失败Promise.allSettled()等待全部结束,返回每项的状态与值Promise.race()第一个结束的结果,无论成功或失败Promise.any()第一个成功的结果;全部失败抛 AggregateErrorasync function总是返回 Promise,返回值会被自动包装await等待 Promise 兑现;暂停当前 async 函数,不阻塞线程try / catch配合 await 捕获异步错误,等价于 .catchqueueMicrotask()显式把回调加入微任务队列
错误与调试
try / catch / finallyfinally 无论是否异常都会执行throw抛出异常,建议抛 Error 实例而不是字符串new Error(msg)通用错误对象,包含 message 与 stackTypeError类型不匹配,如调用 undefined 或给只读属性赋值ReferenceError访问未声明的变量RangeError数值越界,如 new Array(-1)SyntaxError语法错误,解析阶段抛出,try/catch 通常捕不到error.name错误类型;message 是信息,stack 是调用栈console.error()输出错误,保留调用栈与对象结构console.table()以表格展示数组或对象,适合检查列表数据console.time()与 timeEnd 成对使用,输出两标记之间的耗时debugger触发断点,需要打开开发者工具window.onerror捕获全局运行时错误;unhandledrejection 监听未处理的 Promise 拒绝
ES2020+ 新特性
?.可选链,安全访问深层属性(ES2020)??空值合并,只对 null 与 undefined 生效(ES2020)??=逻辑空赋值(ES2021)||= / &&=逻辑或赋值与逻辑与赋值(ES2021)Promise.allSettled()等待全部 Promise 结束(ES2020)String.replaceAll()替换全部匹配(ES2021)Array.at()支持负索引(ES2022)Object.hasOwn()更安全的自有属性判断(ES2022)Array.findLast()从后往前查找(ES2023)Object.fromEntries()键值对数组转对象(ES2019)trimStart() / trimEnd()只去除一侧空白(ES2019)flat() / flatMap()拍平数组(ES2019)BigInt任意精度整数(ES2020)globalThis统一的全局对象引用(ES2020)
宏任务与微任务对比
每个宏任务执行完后,浏览器会把当前微任务队列全部清空,然后才进入下一个宏任务。
因此 Promise 的回调总在同一轮里先于 setTimeout 执行。
| 队列 | 典型来源 | 执行时机 |
|---|---|---|
| 宏任务 | setTimeout、setInterval、DOM 事件回调、I/O |
每轮事件循环取一个执行;执行完后清空微任务 |
| 微任务 | Promise.then / catch / finally、queueMicrotask、MutationObserver |
当前宏任务结束后立即执行,直到队列为空 |
| 同步代码 | 普通语句、Promise 执行器内部 | 先于所有任务队列,在当前调用栈中直接执行 |
一个常见结论。
Promise.resolve().then(fn) 会先于 setTimeout(fn, 0) 执行;
而 new Promise(executor) 里的 executor 是同步的,会最先执行。
浏览器与 DOM
查询、修改、监听与存储:浏览器 API 的边界与常见陷阱。
DOM 查询与操作
querySelector()返回第一个匹配元素,找不到为 nullquerySelectorAll()返回静态 NodeList,不会随 DOM 变化getElementById()按 id 查询,通常是最快的方式closest()从自身向上查找最近的匹配祖先matches()判断元素是否匹配某个选择器createElement()创建元素节点,后续再插入文档append() / prepend()在子节点末尾或开头插入,可传多个节点或字符串before() / after()在元素自身前后插入兄弟节点remove()从 DOM 中移除自身textContent读写纯文本,不解析 HTML,性能更好也更安全innerHTML读写 HTML,注意 XSS 风险,不要拼接用户输入classListadd / remove / toggle / contains 操作类名,避免拼接 classNamedataset读写 data-* 属性,dataset.userId 对应 data-user-idgetBoundingClientRect()返回元素相对视口的位置与尺寸
事件
addEventListener()绑定事件,同一函数重复绑定只会生效一次removeEventListener()解绑,必须传同一个函数引用事件冒泡从目标元素向上传播到祖先事件捕获从根向下传播,options 设为 { capture: true }stopPropagation()阻止事件继续传播,不会阻止默认行为preventDefault()阻止默认行为,如表单提交与链接跳转e.target实际触发事件的元素e.currentTarget当前绑定监听器的元素事件委托监听父元素,用 closest() 判断来源,适合动态列表{ once: true }事件触发一次后自动移除监听{ passive: true }承诺不调用 preventDefault,提升滚动性能input值变化时实时触发;change 在失焦或确认后触发CustomEvent自定义事件,用 detail 携带数据
存储与 BOM
localStorage.setItem()持久存储字符串,同源共享,关闭浏览器仍保留localStorage.getItem()读取,键不存在返回 nulllocalStorage.removeItem()删除单个键;clear 清空当前源全部键sessionStorage会话级存储,关闭标签页后清除存储上限localStorage 通常约 5MB,超出抛 QuotaExceededErrorJSON.stringify()存取对象或数组前序列化,读取时再 parselocation.href当前完整地址,赋值会触发导航location.hash# 后的部分,修改不会刷新页面history.pushState()添加历史记录,不刷新页面history.back()后退一条记录;forward 前进,go(n) 跳转 n 步navigator.clipboardwriteText 写剪贴板,需安全上下文与用户授权window.innerWidth视口宽度,不含浏览器工具栏;innerHeight 为高度matchMedia()媒体查询,可监听深浅色与尺寸变化scrollTo()传入 { top, behavior: 'smooth' } 可平滑滚动
不要把敏感数据放进 localStorage。
localStorage 不加密,同源脚本都能读取,也无法设置过期时间。令牌、密码、身份证号不应写入;
需要过期语义时,存一个时间戳并在读取时自行判断。涉及跨标签页同步时,可监听 storage 事件。