来源书籍

JavaScript权威指南(原书第6版)

Skill 版本:v24 编程语言类 经典(高浓度 + 高稳定性) 940 张卡片

David Flanagan · 淘宝前端团队 译 · 机械工业出版社(电子版:北京华章图文信息有限公司) · 2012 · 第6版 · ISBN 978-7-111-37661-3

类别清单覆盖

5/9

已覆盖 5 补充生成 0 未覆盖 4

全书导读

本书把JavaScript语言和运行它的环境分开讲解。语言核心规定值、对象、函数及求值,浏览器再提供文档、事件、网络、存储与绘图。读者先弄清一个操作作用于什么对象、改变哪种状态、返回什么结果,再看库怎样组合这些操作,才能避免把同名方法或“完成”事件误当相同业务含义。

本笔记依据2012年中文版第6版(原作2011年),完整读取本分册4–50的范围,其中35个实质正文spine分成836单元,另12项非正文逐项确认排除。全书22章、两份API参考及有实质说明的前后文均已纳入;130幅正文图片实际查看。ES3/ES5、Mozilla扩展和2011年前后的浏览器提案保留历史前提,必要差异另以当前规范说明,不能把该版当现行API清单。采用轻量模式,未执行笔记复核、独立审查及审查结果优化。

全书主线

第1章给出语言与客户端全景。第2–5章说明源文本怎样形成值、表达式和控制执行的语句;第6–9章再把状态与行为组织为对象、数组、函数、原型和模块。函数既能保存行为,也能携带词法环境,因此回调与封装的理解以语言规则为基础,而不是记住某个框架写法。

第10章进入正则匹配;第11章用标准、子集与扩展说明语言边界,第12章展示Rhino与当时Node怎样给语言补上服务器平台能力。这一过渡解释为什么同为JavaScript,浏览器的document与服务器文件接口并不通用。

第13–17章从浏览器执行模型进入Window、DOM、样式和事件。DOM节点保存文档结构,样式决定呈现,事件把交互转成回调;三者相关但不能互相替代。第18章把异步调用伸向网络,第19章展示jQuery怎样把查询、集合和批处理包装成链式接口,第20章转向客户端状态与离线,第21–22章再将图形、媒体、线程、文件和结构化存储接入相同的状态与事件思路。

第三、四部分按对象提供核心及客户端接口参考。本笔记将重复机制并回前面概念,真正新增的契约另作卡片;参考签名用于查操作对象和参数边界,不能代替原理,更不能把已变动的旧接口当现代兼容保证。

译者序

译者序说明第6版围绕ES5与当时HTML5生态修订,并记录七位译者。评价与当时的流行程度属于出版背景,不改写成今天的技术排序。

前言

本书把语言及宿主环境分开,先用两部分解释机制,再用两部分提供按对象检索的参考。ES5与HTML5被称为最新,是本书写作时代的描述;读者要把这种时间前提带入后续示例。

第1章 JavaScript概述

JavaScript的语言标准、具体实现、引擎版本与宿主API是不同对象。语法看起来像Java不表示类型和继承机制相同;函数能作为值,原型又提供对象之间的共享查找关系。语言核心定义基本值及内置对象,浏览器等宿主补上I/O和平台能力。控制台可用于观察短程序,图1-1只是历史Firebug界面的操作示例,不作为当代安装建议。

JS语言血统的三重混合

JavaScript的语法外观借鉴Java,一等函数的设计受到Scheme影响,原型式继承受到Self影响。“一等函数”表示函数能作为普通值传递和保存,“原型”让对象可复用另一个对象上的属性。这些是不同层面的借鉴,语法相似并不代表JavaScript和Java具有相同的类型、对象和执行模型。

JS语言血统的三重混合保存独立卡片。

原书依据 · 1 处

语言标准不同于引擎版本

ECMAScript描述语言规则,JavaScript引擎是具体执行这些规则的实现。Mozilla曾用JavaScript1.x表示自身版本,V8也有独立版本序列;这些编号不能直接互相替换。本书覆盖ES3与ES5,并包含当时Mozilla扩展,使用示例前应区分标准能力、实现扩展和具体引擎支持。

语言标准不同于引擎版本保存独立卡片。

原书依据 · 2 处

宿主环境提供平台能力

语言核心与宿主环境承担不同职责:核心定义值、对象、函数和文本数组等内置操作,宿主提供网络、存储、图形或文档等平台能力。浏览器是一种宿主,服务器也可以承载JavaScript。因此同一门语言中存在某个对象名,不代表它能在所有运行环境使用。

宿主环境提供平台能力保存独立卡片。

原书依据 · 2 处

控制台提供短程序反馈

浏览器开发者工具的控制台可以输入并观察短段JavaScript;console.log提供较少打断页面的输出,alert会弹窗打断交互。控制台适合学习和诊断,不等于完整应用验证。本书截图中的Firebug属于历史工具,快捷键和具体功能要按实际浏览器核验。

控制台提供短程序反馈保存独立卡片。

原书依据 · 1 处

1.1 JavaScript语言核心

本节用小程序串起值、变量、对象、数组、表达式、函数及控制结构。变量保存值,表达式求值,语句组织执行,函数又可作为值放进对象属性;构造函数配合原型提供实例初始化与共享方法。概览有几处过度概括:表达式可以通过赋值或自增改变状态,函数不必总有名字,空对象并不表示原型上没有可见属性,this也不是永远绑定定义方法的对象。示例还有全角运算符和排版错位,下面解释语义而不声称代码可原样运行。

变量名与所存值分开

变量是用于引用值的名字,声明与赋值不是同一动作。示例先用var声明x,再依次把数字、字符串、布尔值、null和undefined赋给它,说明同一变量并未被这次声明永久限制为某种值类型。这是本书ES3/ES5写法的概览,后续还需区分作用域和初始化状态。

变量名与所存值分开保存独立卡片。

原书依据 · 2 处

对象用属性名组织值

对象以属性名关联值,示例book既可以用book.topic访问固定名称,也可以用方括号访问属性。属性的值还可以是对象或数组,因而能组合出多层数据。对象字面量中的空花括号表示没有显式初始化自有属性,不应由此推断它通过原型也无法看到任何属性。

对象用属性名组织值保存独立卡片。

原书依据 · 1 处

数组用位置索引组织值

数组按数字索引组织值,示例primes从索引0读取首项,也能在指定位置添加或修改值。数组可以包含对象,反过来对象属性也可以保存数组,从而把结构与顺序组合起来。示例使用稠密数组;length是长度属性,不应不加条件地当成所有数组中实际存在元素的数量。

数组用位置索引组织值保存独立卡片。

原书依据 · 1 处

表达式可以产生副作用

表达式求值得到结果,但求值也可以改变状态,例如本节的count++和count+=2会更新count。语句负责组织声明、分支、循环等执行步骤,不能简单以“是否改变状态”区分它与表达式。本节把表达式概括为不做操作,与它自己的赋值及自增示例不一致。

表达式可以产生副作用保存独立卡片。

原书依据 · 3 处

运算符含义依赖操作数

运算符把操作数结合成结果,其含义要连同操作数理解:3+2进行数值加法,字符串”3”+“2”得到”32”。赋值号=与相等比较也不同。本节用布尔比较组合演示逻辑运算;不能由这些示例推断逻辑运算在所有输入下都只返回布尔值,具体转换和短路规则在后文展开。

运算符含义依赖操作数保存独立卡片。

原书依据 · 2 处

函数值可保存与组合

函数封装可重复调用的参数化行为,也是一种值。示例将匿名函数赋给square,再把plus1(y)的结果作为square的参数,体现“保存行为”和“组合计算”两种能力。函数声明的名字、接收函数值的变量名及函数内部自身名字是不同概念,不是每个函数都必须具备固定名称。

函数值可保存与组合保存独立卡片。

原书依据 · 4 处

方法调用给出接收对象

函数作为对象属性使用时可充当方法。示例points.dist()在方法体中通过this读取当前数组,再计算两个点的距离;这里的接收对象由调用形式提供。不能把它改写为this总是指向当初定义该函数的对象,换一种调用形式可能改变接收者。

方法调用给出接收对象保存独立卡片。

原书依据 · 2 处

分支与循环组织重复计算

if/else按条件选择路径,while和for反复执行循环体。两个阶乘示例分别递减n与递增i,把乘积积累后返回;控制结构表达执行次序,函数表达可复用的整体行为。示例只展示正常非负整数范围的意图,不证明它已处理负数、非整数或数值溢出等输入。

分支与循环组织重复计算保存独立卡片。

原书依据 · 1 处

构造函数初始化实例

示例通过new Point(1,1)创建实例,构造函数把参数保存为实例的x、y属性,Point.prototype.r则保存计算到原点距离的方法。每个实例保有自身坐标,通过原型查找共享方法;构造函数、原型对象与实例是三个不同角色,不是同一个对象。

结构图: 类图中节点分别表示构造函数、原型对象和示意实例;箭头为属性、原型查找或创建依赖,未画成类继承。

classDiagram
 class PointCtor["Point(构造函数,非类型)"] {
  +Point(x,y)
 }
 class PointPrototype["Point.prototype(原型对象)"] {
  +r()
 }
 class PointInstance["Point实例(示意)"] {
  +x
  +y
 }
 PointCtor --> PointPrototype : prototype属性
 PointCtor ..> PointInstance : new创建
 PointInstance --> PointPrototype : 原型查找r

构造函数初始化实例保存独立卡片。

原书依据 · 2 处

1.2 客户端JavaScript

客户端程序把脚本载入文档,通过DOM节点修改内容,通过样式属性改变呈现,再把函数注册为事件处理器,让浏览器在事件到来时调用。原生与jQuery两个debug实现的共同点是先定位容器,再把消息作为文本节点加入;库封装了同一组平台任务。历史示例有className拼接缺少空格、attachEvent分支仍使用event.target等问题,不能照抄为兼容方案。定时器表示安排回调,不应理解为精确时刻保证。

脚本可内嵌或从文件载入

HTML中的script元素可以包含脚本正文,也可以通过src引用外部脚本文件。外部文件便于在多个页面复用,内嵌代码直接属于当前文档。此处仅展示经典脚本的基本载入方式;加载顺序、异步及安全策略在后文按实际环境进一步说明。

脚本可内嵌或从文件载入保存独立卡片。

原书依据 · 4 处

定时器安排后续回调

setTimeout接收回调和延迟,本节示例安排稍后调用moveon,再依据确认结果决定是否导航。安排回调与立刻执行函数不同,延迟也不应当作实际执行时刻的精确承诺。此处浏览器接口属于宿主能力,函数本身的定义并不会自动安排执行。

数字时钟示例每次读取new Date()再安排后续显示,因此显示依据是执行时的当前时间;递归安排回调仍不能保证恰好每秒执行。

定时器安排后续回调保存独立卡片。

原书依据 · 5 处

文本节点保留消息的数据语义

示例debug先寻找调试容器,不存在时创建,再把msg交给createTextNode,包进pre后追加到容器。固定标题可用预先给定的HTML,消息则作为文本处理;这区分了“加入一段文字”和“把文字解释为HTML结构”。jQuery示例的text(msg)承担对应责任,不把消息内容拼成标记。

文本节点保留消息的数据语义保存独立卡片。

原书依据 · 6 处

隐藏显示与布局空间分开

示例用display:none让元素不再占据通常布局空间,用visibility:hidden隐藏可见内容而保留空间。两者都可能让用户看不见元素,却对周围布局有不同影响;选择应由是否希望版面回流决定,不能只比较“隐藏”这个表面结果。

隐藏显示与布局空间分开保存独立卡片。

原书依据 · 1 处

事件处理器由事件驱动调用

事件处理器是先注册、在指定事件发生时由浏览器调用的函数。点击、键盘、加载和窗口变化等事件,让程序围绕交互组织行为,而不需要持续自己检查所有输入。注册函数与执行函数不同;实际回调能取得什么事件对象及接收者,还取决于注册接口与环境。

事件处理器由事件驱动调用保存独立卡片。

原书依据 · 5 处

jQuery封装文档操作

jQuery通过选择元素、创建节点、追加内容和注册行为等接口,封装常见浏览器文档操作。本节两个debug实现展示:库版仍是在定位或创建容器后把消息作为文本追加,只是表达更紧凑。书中对IE6兼容与流行程度的描述属于当时版本背景,不是所有当前版本和环境的保证。

jQuery封装文档操作保存独立卡片。

原书依据 · 1 处

示例:一个JavaScript贷款计算器

贷款计算器把输入、计算、显示、保存、网络请求与绘图组合成一个页面。输入事件或按钮触发calculate,它读取表单字符串并换算单位,再计算近似月供;有效数值用于更新输出、保存输入及绘图,非有限结果清空旧内容。找放贷人的后端在示例中并未实现,网络返回后的处理位于独立回调;不能把外层try/catch当作覆盖所有异步错误。图1-2展示页面与累计付款、偿还本金和余额曲线,不证明真实贷款费用已被完整建模。

表单值先转换再计算

表单input的value提供文本,参与计算前要转换成数值并明确单位。示例将本金转为数值,把年利率百分数除以100和12换为月率,再把年数乘12得到期数。这些换算属于输入契约;成功解析一个前缀或得到有限结果,并不自动证明完整输入合法、期限为正或满足实际业务要求。

表单值先转换再计算保存独立卡片。

原书依据 · 1 处
月供公式有适用前提

示例用本金P、月利率r和总期数N,先算x=(1+r)^N,再按P×x×r/(x−1)估算固定月供。它假设按相同月率与等额月供计算,显示时保留两位小数;并未建模全部费用或真实结算舍入。由式子可直接看出r=0时会产生0/0,说明公式及输入分支还需边界处理,不能把输出有限当成完整金融正确性证明。

月供公式有适用前提保存独立卡片。

原书依据 · 1 处
无效新结果要清除旧展示

界面已有结果后,新的不完整输入可能使计算失败。示例在monthly不是有限数时清空月供、总额、总利息并调用无参数chart清图,避免旧结果继续像是当前输入的答案。isFinite检查的是数值有限性,不能代替所有业务条件验证。

无效新结果要清除旧展示保存独立卡片。

原书依据 · 1 处
显示舍入不同于内部计算

toFixed(2)将计算结果格式化为两位小数的文本。示例显示月供时这样格式化,但总额仍使用未格式化的monthly乘期数,因此“显示月供×期数”未必等于显示总额。展示精度与实际记账舍入是不同契约,此例只演示近似页面输出,未执行实际扣款或证明账务一致性。

显示舍入不同于内部计算保存独立卡片。

原书依据 · 1 处
保存输入与恢复界面配对

示例save把输入字符串写入localStorage,页面load时再把已有值填回相应input,从而减少重复输入。能力检测、保存和恢复属于一条完整用户体验链;存储是否可访问还受实际环境、权限与配额影响,不能把检测到属性等同写入永不失败。这里存的是输入偏好,不是可靠业务账本。

保存输入与恢复界面配对保存独立卡片。

原书依据 · 1 处
异步请求在回调处理结果

getLenders构造URL并发出XMLHttpRequest,随后由onreadystatechange在满足完成状态和HTTP200条件时读取响应并解析JSON。发出请求不表示结果已经到达,调用它的同步流程可以继续。外层包住getLenders调用的try/catch只能处理该同步调用栈的异常,不会因此接住以后独立回调中的解析错误。

异步请求在回调处理结果保存独立卡片。

原书依据 · 2 处
查询参数按值编码

示例用encodeURIComponent分别编码本金、年率、年数和邮编,再把它们放到查询参数中,避免值中的特殊字符被直接解释为URL分隔结构。编码并不证明值符合业务规则,也不等于保密或服务器授权。原书排版的全角连接符不能作为可直接运行代码照抄。

查询参数按值编码保存独立卡片。

原书依据 · 2 处
响应解析不等于可信展示

示例把JSON中的放贷人名称和URL拼成HTML,再交给innerHTML。JSON能成功解析只说明数据可被解释为相应结构,不证明字段可信或链接允许导航;直接插入HTML仍有内容与标记混淆风险。此为按本段代码作的边界分析,不把并未实现的后端服务假定为已经校验安全。

响应解析不等于可信展示保存独立卡片。

原书依据 · 1 处
绘图需转换业务坐标

图表先把期数映射到横向像素,把金额映射到纵向像素,并用height减去缩放金额,让较大金额出现在画布上方。这样付款、累计偿还本金和剩余余额可以共享同一坐标系。比例取决于总额和画布尺寸,不能直接把金额当成像素位置。

绘图需转换业务坐标保存独立卡片。

原书依据 · 1 处
还款曲线逐期更新余额

示例每期先按当前余额乘月率计算利息,再从月供中扣除该期利息,得到偿还本金,并减少余额。把各期余额连线得到下降曲线,累计偿还本金则形成上升区域。曲线说明固定月供中本息构成随余额变化,不保证浮点计算与显示末值符合真实合同和结算规则。

还款曲线逐期更新余额保存独立卡片。

原书依据 · 1 处
画布路径与绘制状态分开

Canvas示例用moveTo、lineTo与closePath构造路径,再用fill或stroke真正呈现填充与轮廓;颜色、线宽和文字对齐是独立绘制状态。开始另一条曲线前调用beginPath,避免把前一次路径意外连接进来。示例把width重新赋给自身,会重置画布和绘图状态,不只是删除某条曲线。

画布路径与绘制状态分开保存独立卡片。

原书依据 · 1 处

第一部分 JavaScript语言核心

第一部分依次讨论词法、值、表达式与语句,再进入对象、数组、函数、类和模块,最后介绍正则、语言子集扩展与服务器宿主。它给出阅读地图,不以标题清单代替任何章的实际阅读。

第2章 词法结构

词法结构规定字符怎样形成名字、字面量、注释和语句分隔,是解释更复杂语义之前的基础。它关心程序文本如何被识别,不等于运行时对象或变量实际怎样存放。

词法规则划定程序文本结构

词法规则说明程序文本怎样形成可识别的基本单位,例如变量名字、字面量、注释以及分隔符。相同的可见排版不一定产生相同语法,某些换行会参与解析。理解这层规则有助于区分文本输入问题与后续运行时计算问题。

词法规则划定程序文本结构保存独立卡片。

原书依据 · 1 处

2.1 字符集

Unicode为源码提供字符范围,具体能用于标识符、空白或其他位置仍由语言规则决定。原书给出ES3与ES5时代的Unicode版本要求,这些是历史兼容背景,而非当前所有引擎永远使用的固定版本。

源码字符集受语言版本约束

Unicode提供源码字符的表示基础,但不表示每个字符都能放在每种语法位置。语言标准及实现版本决定采用的字符属性范围,原书给出的ES3与ES5要求应作为历史兼容前提阅读。字符能显示出来、编码有效和能作为合法变量名,是三个不同判断。

源码字符集受语言版本约束保存独立卡片。

原书依据 · 1 处

2.1.1 区分大小写

大小写是JavaScript标识符身份的一部分。HTML语法中的元素和属性名称有自己的大小写规则,但不能将它推广到所有属性值或JavaScript属性;XML文档也按不同语法处理。

标识符大小写参与身份

JavaScript中online、Online、OnLine和ONLINE是不同名字,关键字也必须采用规定拼写。HTML语法里元素及属性名的ASCII大小写规则不同,不能据此推断JavaScript属性也不区分大小写。例如onclick有固定写法,getElementById却包含大写字母,并不是所有DOM接口都要全小写。

标识符大小写参与身份保存独立卡片。

原书依据 · 1 处

2.1.2 空格、换行符和格式控制符

空白通常分隔词法单元并服务排版,行结束符还可能触发分号插入。格式控制字符不能任意混入标识符;原书把零宽非连接符的码位写成FEFF,是明确的码位错误,已用ES5.1规范表核对。

空白与换行承担不同职责

标识符等词法单元之间通常可插入空白来改善可读性,但不能任意把一个单元拆成几个。行结束符还参与自动分号插入和受限语法,因此换行并非处处没有语义。空白字符集合属于所采用语言版本的规则,不应仅凭屏幕上看起来有间隙判断。

空白与换行承担不同职责保存独立卡片。

原书依据 · 1 处
格式控制字符有位置限制

格式控制字符影响文本显示,并非都可作为标识符字符。ES5背景下,零宽非连接符U+200C和零宽连接符U+200D可出现在标识符首字符之后;U+FEFF是BOM,按空白处理。原书将前者误写成FEFF,笔记保留原始证据并在此校正,不把不可见字符视为可任意插入。

格式控制字符有位置限制保存独立卡片。

原书依据 · 1 处

2.1.3 Unicode转义序列

四位十六进制转义表示一个16位码元,可在规定的字面量和标识符位置使用;它不是让所有语法字符都失去位置限制的通用宏替换。注释中的反斜线文本不会按相同方式变成字符。

Unicode转义依上下文解释

本书的\uXXXX形式用四个十六进制数表示一个16位码元。例如字符串中直接写é与写\u00E9可得到相同内容。转义仍受所在语法位置约束,不能借它把保留字变成普通标识符;放进注释时只是注释文本,也不会因此参与求值。此处是ES5时代形式,不声称概括后续所有转义语法。

Unicode转义依上下文解释保存独立卡片。

原书依据 · 1 处

2.1.4 标准化

视觉上相同的字符可以由不同码元序列表示,语言不会因为看起来相同就自动把它们统一。Unicode有多种规范化形式,应明确所采用形式;原书的单一首选格式说法过于简化。

视觉相同不保证编码相等

é可以写成单一码位U+00E9,也可以写成e加组合重音U+0301,显示近似或相同不保证码元序列相等。JavaScript不会自动把这样的标识符、字符串或正则文本规范化成同一种表示。需要按已选定的规范化形式处理并明确比较契约,不能把视觉一致当作文本身份一致。

视觉相同不保证编码相等保存独立卡片。

原书依据 · 1 处

2.2 注释

单行与块注释都用于解释源码而不作为普通程序文本执行;块注释以首次匹配的结束标记结束,不能以嵌套开始标记增加层级。

注释边界不能任意嵌套

双斜线引入到行末的注释,斜线星号与星号斜线则包围可跨行的块注释。块注释不能嵌套,因此暂时注释一段已经含块注释的代码,可能提前遇到结束标记而改变剩余文本的解释。注释内容仍可能包含换行,不能把删除注释等同任意删除所有分隔。

注释边界不能任意嵌套保存独立卡片。

原书依据 · 1 处

2.3 直接量

字面量在程序文本中直接表达值或构造值的形式,与通过名字取值不同。本节列出数值、文本、布尔、null、正则以及对象数组写法,后文分别展开其求值规则。

字面量直接写出值的形式

字面量是源码中直接表达值的形式,例如12、”hello”、true、null以及正则表达式写法;对象和数组也有对应字面量形式。它与变量名不同:名字需要先查找所引用的值。直接写在源码中也不表示每次求值必然复用同一个对象,具体创建语义需要按相应类型判断。

字面量直接写出值的形式保存独立卡片。

原书依据 · 1 处

2.4 标识符和保留字

标识符为变量、函数及语句标签命名,首字符和后续字符采用不同范围;字符集支持Unicode并不等于任意数学符号都能用作名字。保留字又在字符形状之外增加一层语法限制。

标识符首字符有独立规则

标识符是给变量、函数或标签使用的名字。按本书规则,字母、下划线和美元符可用于起始,数字可出现在后续位置;还允许规定类别的Unicode字符,不能推广为任意数学或显示符号。形状合法也不代表可用,仍要排除当前版本和语境中的保留字。

标识符首字符有独立规则保存独立卡片。

原书依据 · 1 处

保留字

保留字属于语法,预定义全局名则是运行环境提供的绑定,两者限制不同。四张图片分别列关键字、ES5未来保留字、ES3扩展保留集及常见全局名,已逐张实际查看。表中let、class等地位属于历史版本,不能按该表推断今日语法。

保留字取决于版本与语境

语言会把部分名字留给语法,不能当作普通变量标识符使用。本书分别列ES5保留字、严格模式限制及为兼容ES3应避开的名字,说明同一拼写的限制取决于版本和语境。arguments与eval在严格模式下的部分绑定用途受限,也不应简单称为在所有位置都禁用的普通关键字。

保留字取决于版本与语境保存独立卡片。

原书依据 · 1 处
预定义全局名不同于保留字

Array、Math、JSON、parseInt等名字可能由标准或宿主预先提供,但它们与语法保留字不是同一类。用相同名字创建局部绑定可能遮蔽原有入口,使后续代码取得另一份值。需要区分语法是否允许、绑定是否可修改,以及覆盖名字后功能是否仍符合意图,不能把所有全局名都当关键字。

预定义全局名不同于保留字保存独立卡片。

原书依据 · 2 处

2.5 可选的分号

自动分号插入依据语法及受限位置,不是每遇换行就结束语句。能继续组成调用或其他表达式时,换行后的内容可能接到上一行;return和后缀自增等位置又有不同限制。原书将break/continue后内容称表达式不准确,实际是可选标签。

换行不必结束当前语句

自动分号插入依据语法能否继续及特定限制,而非逐行执行的排版规则。示例把x+f后换行接上(a+b).toString(),仍可解析成函数调用,结果是一条合并表达式。需要独立语句时应建立明确分隔,不能仅依赖看起来各占一行。

换行不必结束当前语句保存独立卡片。

原书依据 · 1 处

语句首符号可能接续上一行

左圆括号、左方括号等行首符号可能继续上一行表达式。原书用前置分号保护以数组字面量开始的语句,意图是在前行被修改或漏分号后仍保持语句边界。这是明确分隔的一种写法,不表示所有换行都危险,也不证明一种风格必然优于另一种。

语句首符号可能接续上一行保存独立卡片。

原书依据 · 1 处

受限位置不能随意换行

return后的返回表达式若移到下一行,示例会变成先无值返回,再留下后续语句。break和continue的可选标签也须与关键字同处允许位置;它们后面不是任意表达式。后缀++或–必须紧随同一行操作数,换行可能让它被解释为下一条语句的前缀操作。

受限位置不能随意换行保存独立卡片。

原书依据 · 1 处

第3章 类型、值和变量

本章从“值是什么”和“变量怎样指向值”展开,分开原始值、对象及特殊对象,并引入构造、方法、内存回收和可变性。此为ES5类型范围,不能当作今天所有语言类型的清单;“全局变量处处可见”和“无引用立即回收”等话还需按真实作用域与可达性限定。

原始值与对象承担不同语义

原始值与对象是两类不同的数据。原书ES5范围内,Number、String、Boolean、Null和Undefined是原始类型;对象则组织属性,并可形成数组、函数等具有特殊行为的对象。变量保存值或对象引用,不等于变量声明永久绑定一种类型。本书的历史类型清单不应冒充当前语言的完整清单。

原始值与对象承担不同语义保存独立卡片。

原书依据 · 2 处

原始值不可变与对象引用可变

不可变是指值自身内容不能被改写,不是禁止给保存它的变量重新赋值。字符串可以读取其中片段,但处理字符串通常产生另一个值;对象和数组则可以修改属性或元素。同一个对象被多处引用时,一处修改可能通过另一引用被看到;具体共享与相等规则在本章后文继续说明。

对象赋值复制引用而非复制对象:本节b=a后通过b改元素,a也观察到变化;两个独立对象即使属性相同,普通严格相等仍不认为它们相同。逐属性或逐元素赋值只复制该层的值,嵌套对象值仍是引用,因此不能把这段循环称为深复制。原始值比较也要保留NaN等具体相等规则,不能笼统说内容相等就涵盖全部数值情况。

原始值不可变与对象引用可变保存独立卡片。

原书依据 · 3 处

特殊对象在属性之外增加行为

数组与函数仍是对象,但不只是一份普通属性集合:数组支持按索引组织元素及长度行为,函数还关联可调用代码。可以像对待对象那样保存函数值,同时通过调用来执行行为。某个值是对象,并不表示它与其他对象具有完全相同的操作能力。 Date对象表示日期与时间,RegExp对象表示文本匹配模式,Error对象表示程序错误;这些也是对象的用途分类,不是与对象平行的新原始类型。

特殊对象在属性之外增加行为保存独立卡片。

原书依据 · 1 处

自动内存回收管理对象存活

JavaScript运行环境自动管理普通对象内存,程序可以创建对象而不逐个手工回收。一个对象不再对活跃程序可达时,才可能成为回收对象;不能把“内部仍有引用”或“变量刚离开作用域”直接等同实际回收时刻。本书只介绍自动管理职责,没有规定回收算法、立即执行或资源释放时间表。

自动内存回收管理对象存活保存独立卡片。

原书依据 · 1 处

3.1 数字

本节的数字规则应明确指Number:它用双精度二进制浮点格式,整数写法不单独形成另一种Number类型。可精确表示某个整数与能可靠区分它的相邻整数不是同一问题;还要分开源文字面量和一元负号。

Number使用双精度二进制

本书的Number采用IEEE754双精度二进制模型,整数写法与小数写法不会因此成为两种Number类型。它能表达很大和很小的量,却只提供有限精度;某些整数操作另有32位转换规则。应把这些Number规则与语言后来增加的其他数值能力分开,不再笼统称今天所有数字都只有同一种表示。

Number使用双精度二进制保存独立卡片。

原书依据 · 1 处

精确整数边界不同于安全整数

从−2^53到2^53的每个整数都能以Number精确表示,但端点附近不再能区分所有相邻整数。例如2^53本身可表示,2^53+1却不能独立表示。因此“这个整数能表示”不同于“相邻计算仍可靠”,安全整数边界应排除这两个端点;更大的整数也可能个别可表示,不能用范围外一律不精确来概括。

精确整数边界不同于安全整数保存独立卡片。

原书依据 · 1 处

负号不属于数值字面量

源码中的−3由一元负号作用于数值字面量3形成,负号本身不是数字字面量的一部分。区分词法单位和运算有助于理解表达式的优先级及解析;负的计算结果不意味着词法层存在另一类带符号数字记号。

负号不属于数值字面量保存独立卡片。

原书依据 · 1 处

3.1.1 整型直接量

十进制与十六进制只是值的不同源码写法。以0开头的遗留八进制与后续语言的显式进制前缀不能混同;原书把严格模式相关版本写为ECMAScript6,应按本书ES5背景理解和核对。

整数进制写法有版本边界

整数可用十进制数字序列或0x/0X开头的十六进制字面量表达,例如0xff表示255。原书还讨论0377这种遗留前导零八进制写法的实现差异及严格模式限制;这不能扩展成所有时代的八进制语法都不可用。阅读旧代码应先识别具体记号,再核对目标语言版本与模式。

整数进制写法有版本边界保存独立卡片。

原书依据 · 1 处

3.1.2 浮点型直接量

小数点写法与e/E指数写法都表达Number值,指数部分以十为底。例如6.02e23表示6.02乘10的23次幂,不能因为指数写法很短就认为结果精确或没有范围限制。

小数与指数是数值表示形式

Number字面量可以用小数点表示,也可用e或E附加十进制指数,例如6.02e23表示6.02×10^23。指数符号后可带正负号,作用是改变数量级,并不会改变底层有限精度。源码写出的十进制表达式是否能被二进制精确保存,仍须另行判断。

小数与指数是数值表示形式保存独立卡片。

原书依据 · 1 处

3.1.3 JavaScript中的算术运算

普通算术和Math提供计算入口,Infinity、NaN及负零又使某些边界不通过异常报告。原文对无穷运算、MAX_VALUE加1及isNaN/isFinite的描述过于宽泛:无穷间的某些运算得到NaN,最大有限值加极小量可能因舍入不变,全局检测函数还会转换参数。

Math按计算用途提供函数

Math把常见数学操作组织成函数和常量,可按用途查找:pow与sqrt处理幂和根,abs/max/min处理大小,round/ceil/floor处理不同方向的取整,log/exp及三角函数处理相应关系。选择取整时要考虑负数方向,例如向上取整并非统一“远离零”;具体边界与精度仍属于Number规则。

Math按计算用途提供函数保存独立卡片。

原书依据 · 1 处
伪随机值不是安全随机保证

本节Math.random提供落在大于等于0、小于1范围的伪随机值,可用于普通随机化。区间与用途是接口说明,不能据此推定密码令牌安全、严格均匀或可重复的种子契约。涉及安全凭据时,应另核对宿主提供的安全随机接口,而不是仅依赖这个函数名。

伪随机值不是安全随机保证保存独立卡片。

原书依据 · 2 处
特殊数值不总通过异常报告

Number运算可能产生Infinity、NaN或带符号的零,而不抛出异常。非零有限数除以零可得到带符号无穷,0/0得到NaN;Infinity−Infinity及0×Infinity也不能照“仍是无穷”理解。最大有限值加1还可能因舍入保持原值,并非原书注释所称必得Infinity,应核对实际数量级与操作。

现行全局Infinity属性不可写、不可枚举且不可配置,参考条目“可设为任意值”是旧版信息;局部同名绑定是另一问题。无穷仍是Number值,不代表有限可用业务量。

特殊数值不总通过异常报告保存独立卡片。

原书依据 · 5 处
NaN检测要考虑隐式转换

NaN与自身也不相等,因此不能用x==NaN识别它。全局isNaN先对参数作数值转换:能转换成数字的字符串未必被判为NaN;全局isFinite同样不是只接受Number的类型守卫。需要区分“转换后不是有效数”“本来就是数值NaN”和“数值有限”三个问题。

全局isFinite先做数值转换,能转换的字符串、null等也可能返回true;需要限定原生Number时须把类型条件与有限条件一起表达,或采用相应不转换接口。转换本身也可能抛异常,不能假定任何输入都返回布尔值。

NaN检测要考虑隐式转换保存独立卡片。

原书依据 · 5 处
正零负零相等但符号可见

Number包含正零和负零,使用严格相等比较时两者相等,但符号仍能影响运算,例如1除以正零与负零分别得到正无穷与负无穷。负数下溢也可能产生负零。相等比较结果不代表所有后续运算行为都完全相同,尤其不能忽略分母与极限方向。

正零负零相等但符号可见保存独立卡片。

原书依据 · 1 处

3.1.4 二进制浮点数和四舍五入错误

有限二进制表示不能准确保存所有十进制小数,舍入会使看似同样的减法得到不同结果。本节用美分差值比较说明金额精度,并建议以整数最小单位表示;这不保证整数可无限增长,也不能把误差影响限定为相等比较。

二进制浮点数舍入误差的通用性

有限二进制浮点可以精确表示1/2等数,却不能精确表示0.1等许多十进制小数,数值会按有限格式舍入。本节两次减法给出不相等的近似值,说明这不是JavaScript独有现象,而是相同表示条件下的共同限制。误差不只影响相等比较,还可能在累计、阈值或格式化时显现;不能概括成所有IEEE754格式都必须有同一种十进制误差。

二进制浮点数舍入误差的通用性保存独立卡片。

原书依据 · 1 处
小数金额差值出现比较偏差

用Number计算0.3−0.2与0.2−0.1时,原书展示两者比较不相等,前者也不等于表示0.1的Number。具体场景是美分差额看似相同,但输入已被二进制近似,减法又参与舍入,因而不能把数学上的十进制相等直接套到该表示的比较。该现象与整数最小单位保存金额中的表示方案配对,不把示例冒充实际扣款事故。

小数金额差值出现比较偏差保存独立卡片。

原书依据 · 1 处
整数最小单位保存金额

对固定最小单位的金额,可把“元的小数”转换成“分的整数”后计算,从表示上避开本节十进制小数不能精确存入二进制的根因。这要求输入转换和单位一致,并保证Number整数范围;更细计价、除法及舍入仍须另外约定。它回应小数金额差值出现比较偏差,不表示所有金融计算都只能采用整数或无需检查溢出。

整数最小单位保存金额保存独立卡片。

原书依据 · 1 处

3.1.5 日期和时间

Date对象提供日期构造、字段读取和时间差计算,月索引从0开始,与日号不同。原书星期例子明显有误:0表示星期日,5表示星期五,而且2011-01-01实际是星期六;本次未运行该段JavaScript。

日期字段使用不同索引约定

Date构造及getMonth使用从0开始的月份,getDate读取从1开始的日号,getDay则以0表示星期日。把这些字段当成同一种编号会产生偏移错误。本书2011年1月1日示例中的星期注释有误,5不是星期一;读取本地小时与UTC小时也要明确采用的时间基准。

日期字段使用不同索引约定保存独立卡片。

原书依据 · 18 处

3.2 文本

字符串在语言模型中是16位码元序列,length和传统索引按码元工作,补充平面字符需代理对。原书排版将数学斜体e显示成普通e,不能据此认为ASCII字母e长度为2;也不能从语言模型推断引擎物理内存布局必须始终如此。

字符串长度按码元计数

JavaScript字符串的length按16位码元计数,不等于屏幕上可见字符的数量。基本多语种平面中的普通字符通常占一个码元,U+1D452这类补充平面字符需两个码元;普通ASCII字母e仍只占一个。按传统索引截取时可能拆开代理对,字符串模型也允许不成对代理项,因此长度正确不等于文本边界正确。

String.fromCharCode按16位码元构造字符串,传入大于65535的数值也不能当完整补充平面码点直接使用;charCodeAt与它配对的是码元层,而不是用户可见字符或完整码点层。

字符串长度按码元计数保存独立卡片。

原书依据 · 5 处

字符串模型不等于存储布局

语言把字符串作为16位值序列来定义长度与部分操作,这是程序可观察的语义模型。它不要求所有引擎在物理内存中永远采用相同宽度和布局。原书围绕UTF16说明代理对与传统操作边界,应从接口语义理解,不能据此推测某个引擎的压缩字符串或分配方式。

字符串模型不等于存储布局保存独立卡片。

原书依据 · 1 处

3.2.1 字符串直接量

单引号和双引号都可定界字符串,内部遇到相同分隔符需要转义。源码用反斜线接续下一行,不会因此把换行写进字符串;反斜线n才表达换行内容。HTML属性再包一层脚本时,要分别维护两种解析边界。

源码续行不同于字符串换行

本书ES5写法允许字符串字面量以反斜线接续源码下一行,续行符及行结束不成为字符串内容。若想让值里真正包含换行,需要使用\n等相应转义。源码看起来多行和输出值包含多行是不同事实;示例行中的说明注释不能插在续行反斜线之后当作仍然合法的字符串。

源码续行不同于字符串换行保存独立卡片。

原书依据 · 1 处
嵌套字符串有多层分隔边界

JavaScript字符串内要表达HTML,或HTML属性中要表达JavaScript时,两层语法都要能识别自己的边界。单双引号交替能让简单例子更清楚,但不是通用编码算法;遇到相同引号、反斜线或不可信内容仍须按具体上下文处理。写得可读不等于已经避免内容被解释成代码。

嵌套字符串有多层分隔边界保存独立卡片。

原书依据 · 1 处

3.2.2 转义字符

转义序列让字符串中表达定界符、反斜线和不便直接输入的字符,表3-1的两幅图已实际读取。十六进制短形式与Unicode四位形式范围不同;未知转义的历史处理不能概括成任何语法位置都能去掉反斜线。

字符串转义保留特殊内容

字符串中可用转义表达换行、引号与反斜线,例如\n表示换行,\‘表达单引号而不结束单引号字符串,\表达反斜线。\x后接两位十六进制,\u后接四位,后者表示16位码元而非任意长度的Unicode码点。具体转义要按字符串形式与语言版本理解,不把历史未知转义规则推广到所有上下文。

字符串转义保留特殊内容保存独立卡片。

原书依据 · 1 处

3.2.3 字符串的使用

字符串提供定位、切片、分割、替换及大小写变换,这些接口不会修改原始字符串。原文把普通字符串模式replace称全文替换过于宽泛;需要区分首次匹配替换与指定全局匹配的行为。

原始值不可变与对象引用可变关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处
字符串按用途读取与变换

读取字符串可按码元位置或索引寻找,substring/slice取得片段,indexOf/lastIndexOf寻找位置,split按分隔得到片段集合;这些结果有不同形状,不能混为“修改字符串”。替换和大小写变换返回新字符串,原字符串保留。普通字符串模式的replace通常只替换首次匹配,不能将示例注释当作无条件全局替换。

trim返回去掉两端规定空白后的文本,中间空白和不属该集合的不可见字符仍可存在;它不是通用字符清洗或业务输入验证。

字符串按用途读取与变换保存独立卡片。

原书依据 · 4 处

3.2.4 模式匹配

RegExp表示匹配规则,字面量与构造形式创建这种特殊对象。规则可以交给字符串API执行查找、抽取、替换或分割;各操作返回结果不同。原书testing:1,2,3示例首个数字位于索引8,search注释中的9是错误。

正则对象表达文本匹配规则

RegExp对象保存文本匹配规则,字面量可用斜线包围模式并带修饰符,例如i表达忽略大小写,g用于相应API的全局匹配。规则不等同某次匹配结果:test回答是否匹配,search提供位置,match提取匹配内容,replace与split则产生新的文本或片段。具体正则语义仍需按目标版本核对。

正则对象表达文本匹配规则保存独立卡片。

原书依据 · 2 处
匹配操作返回不同结果

同一个数字模式用于不同字符串接口时,test可产生布尔结果,search返回首位置,带g的match取得多个匹配,replace可把数字段改为占位文本,split按相反规则切分。原书testing:1,2,3中首个数字1的零基索引为8,不是注释中的9。结果形状与索引约定要分别核对,不能只看输出看似合理。

匹配操作返回不同结果保存独立卡片。

原书依据 · 2 处

3.3 布尔值

布尔类型只有true与false,控制结构还会把其他值按规则转成真假。需要区分缺失与零或空字符串时,应显式比较,而不是统一靠if(value)。原书把逻辑与或概括成总返回布尔值是不准确的,它们可以返回操作数。

真假转换不同于值是否缺失

本书ES5范围内,undefined、null、正负零、NaN、空字符串和false在条件中为假,普通对象与非空字符串等为真。if(value)把这些假值一起归为同一分支,因此不能单靠它区分“没有值”和合法的0或空字符串。应根据变量允许的值域选择显式比较;空数组和空对象也不是自动的假值。

真假转换不同于值是否缺失保存独立卡片。

原书依据 · 1 处

逻辑与或可以返回操作数

逻辑与和逻辑或根据真假决定是否继续计算,但表达式结果可以是被选中的操作数,不保证是true或false。非运算符!才直接得到相反布尔值。本节示例使用布尔比较,所以表现为布尔结果;不能将这种输入条件省掉后推广到所有用法。

逻辑与或可以返回操作数保存独立卡片。

原书依据 · 2 处

3.4 null和undefined

null和undefined都是各自原始类型的值,不因typeof null的历史结果而成为对象。undefined可能来自未提供或未初始化,也可能被程序显式保存;读取到它不能证明属性一定不存在。二者用于接口时应明确契约,不一律把undefined认作错误。

null与undefined的语义分工

null常用来显式表达没有值,undefined常见于未初始化的var、缺少的参数、无返回值函数及未找到的属性,但这些是常见来源,不是“正常”与“错误”的绝对划分。属性也可能存在而其值就是undefined;接口可以有意使用它。二者==比较相等而===可区分,均不可直接访问成员;typeof null为”object”也不改变null是原始值的事实。

null与undefined的语义分工保存独立卡片。

原书依据 · 1 处

3.5 全局对象

全局对象向执行环境暴露一组预定义属性,浏览器又在语言内置功能之外提供窗口能力。原书顶层this、全局var与对象属性的关系属于传统脚本背景,不能直接推广到模块、let/const或所有服务器宿主。

全局对象连接标准与宿主入口

全局对象提供一组可直接使用的入口,包括NaN等属性、parseInt等函数、Date等构造函数以及Math和JSON对象;浏览器宿主再补充窗口相关能力。这些是执行环境中可取得的名字,不因预定义就变成语法保留字。具体宿主和执行上下文决定还会有哪些入口,不能只凭语言名称推定。

全局对象连接标准与宿主入口保存独立卡片。

原书依据 · 3 处

顶层this的含义受环境约束

原书通过传统浏览器脚本顶层的this和window取得全局对象,并说明全局var会与对象属性关联。这些结论带有脚本及宿主前提,不能推广为模块顶层this或所有顶层绑定都具有同样行为。读取旧代码时,应先识别它运行在经典脚本、模块还是其他宿主包装中。

顶层this的含义受环境约束保存独立卡片。

原书依据 · 1 处

3.6 包装对象

原始字符串、数字和布尔值可通过包装语义访问属性方法,但这不保证实现每次都分配临时对象。对原始值挂新属性不能持久保存,严格模式还可能报错;显式new包装对象则是实际对象,真假与严格比较不同。

包装对象的临时装箱现象

原始字符串、数字和布尔值可表现得像临时包装对象一样访问属性与方法,这是语言语义的解释,不保证引擎真的每次分配再销毁对象。给原始字符串新增len属性后通常不能再读出持久状态;严格模式的这类赋值还可能抛出TypeError,不能保证总静默忽略。null与undefined没有对应的这种属性访问包装。

包装对象的临时装箱现象保存独立卡片。

原书依据 · 1 处

显式包装值仍是对象

new String、new Number和new Boolean创建对象,不能与对应原始值完全互换。即使某些宽松比较或转换得到相同内容,typeof与严格相等仍能体现对象身份;布尔包装对象本身也会按普通对象参与真假判断。显式包装与调用String等转换函数是不同用途,不应只因名字相同就混用。

显式包装值仍是对象保存独立卡片。

原书依据 · 1 处

3.7 不可变的原始值和可变的对象引用

不可变值、对象身份、共享引用和复制深度是不同问题。对字符串调用变换方法得到新值;将数组引用赋给另一变量则共享原对象;按元素复制只产生新的外层数组,不能据此推断嵌套对象也被复制。

原始值不可变与对象引用可变关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

浅层数组相等不等于深层相等

示例equalArrays先比长度,再以严格不等逐项判断,因此只表达当前层元素的比较。两个嵌套对象即使内容相同,也可能因为身份不同而被判为不同;稀疏槽位、额外属性及NaN等也需要按目标契约另行处理。比较函数应说明它关心的是哪一层和值的哪一种相等,而不是把名字当作通用深比较保证。

浅层数组相等不等于深层相等保存独立卡片。

原书依据 · 1 处

3.8 类型转换

类型转换由使用位置决定,不是给值打上永久新标签。同一个输入在字符串、数字、真假或对象上下文会得到不同结果;表3-2的图片已实读。原始值到对象也必须区分抽象转换与显式Object函数的特殊行为。

转换目标由使用位置决定

运行位置需要字符串、数值或真假时,会应用相应转换规则。同一个字符串与数字相加可能参与连接,与另一个字符串相乘则可能转成数值;不能把一种转换结果当成其他运算的通用预处理。原书10+“objects”的结果不应凭空含空格,真正参与连接的是源码中的字符。

转换目标由使用位置决定保存独立卡片。

原书依据 · 1 处

完整数值转换有意外边界

Number转换会按完整输入规则处理字符串,空白或空字符串可得到0,无法作为完整数值解释的文本可得到NaN;null可转为0,而undefined转为NaN。它回答的是转换规则,不证明某个表单已经填写有效金额。输入验证要先决定是否允许空缺,再决定怎样转换。

完整数值转换有意外边界保存独立卡片。

原书依据 · 3 处

3.8.1 转换和相等性

某个值在条件中转成false,不等于它在宽松比较中与false相等。相等操作有自己按类型分支的规则,严格比较则不做这些跨类型转换。

真假判断不等于宽松相等

undefined用于if条件会转为false,但undefined==false仍不成立。条件转换与宽松相等采用不同规则,后者不会简单把两边都转换成布尔值后比较。严格相等避免宽松比较中的跨类型转换,也仍要遵守NaN、对象身份等本类型规则,不能把它理解成任意深层内容比较。

真假判断不等于宽松相等保存独立卡片。

原书依据 · 1 处

3.8.2 显式类型转换

显式转换让目标类型可见,转换函数不带new时与显式包装对象不同。数值格式化分别控制基数、小数位和有效位,字符串解析又要分开完整转换与前缀提取。原书Number只能十进制、toFixed从不用指数以及x加空串总等于String的说法均需限定。

转换函数与包装构造分开

不使用new调用String、Number和Boolean,主要目的是把输入转换为对应原始值;使用new则创建包装对象。Object函数有额外约定:以null或undefined调用时可返回新空对象,这不同于在需要对象成员访问时发生的抽象转换错误。相同名字不意味着调用形式可以互换。

转换函数与包装构造分开保存独立卡片。

原书依据 · 9 处
简写转换并非总能互换

双叹号可显式取得真假,一元加号在本书Number语境中表达数值转换,而x加空串会经过加法的原始值转换及连接规则。对象可为不同转换提示提供不同结果,因此x+““不能无条件当成String(x)的通用替代。需要表达具体转换契约时,优先让目标和前提可读。

简写转换并非总能互换保存独立卡片。

原书依据 · 1 处
数值格式化先选精度含义

toFixed按小数位数组织输出,toExponential采用指数形式,toPrecision按有效数字位数选择表示;它们都返回字符串。小数位与有效位不同,显示格式也不能消除源数值的二进制近似。toFixed并非任何数量级都保证不出现指数,原书的绝对说法不准确。

现行toFixed/toExponential支持小数位0至100,toPrecision有效位1至100;原书0至20、1至21是旧版范围。toFixed在绝对值达到10^21时可用指数形式,toPrecision对很小数量级也可能用指数形式,不只看整数部分位数。

Number.toString(radix)在现行规范中支持2至36,默认10,越界会RangeError;不应按旧参考把非10进制输出当任意值。它是表示转换,不是把当前Number改成另一种内部数字类型。

数值格式化先选精度含义保存独立卡片。

原书依据 · 5 处
进制输出与进制解析要配对

Number的toString(radix)可按指定基数生成数字文本,parseInt(text,radix)按明确基数解析整数前缀,常用范围为2至36。输出文本若需要0x等展示前缀,应与接收方解析约定一致。不要把遗留前导零行为当成所有版本默认规则,省略基数也不是业务输入验证。

进制输出与进制解析要配对保存独立卡片。

原书依据 · 1 处
前缀解析不证明全串合法

parseInt和parseFloat可以从合法数值前缀取得结果,并忽略后续无法继续解析的内容,因此”3.14 meters”可被提取成3.14。Number更接近完整字符串转换,但并非只支持十进制;原书的“只能十进制”描述不准确。选择应取决于要提取前缀还是验证完整字段,两者都不能自动替代业务范围检查。

前缀解析不证明全串合法保存独立卡片。

原书依据 · 1 处

3.8.3 对象转换为原始值

普通对象转成原始值时,可能调用自身的转换方法,而真假转换不需要先取出包装对象的内容。ES5路径中字符串提示先试toString,数值提示先试valueOf;返回另一个对象不算成功,要继续尝试或失败。Date在默认提示中有特殊偏好,不能用一种顺序解释所有运算。

布尔包装内容不决定对象真假

new Boolean(false)仍是对象,按本节普通对象的真假规则会被当作真。它的内部布尔内容与“这个对象作为条件是否为真”属于两种不同操作。这样就能解释为什么包装值并不总与原始false互换,不能仅因显示或宽松比较相似就认定条件行为一致。

布尔包装内容不决定对象真假保存独立卡片。

原书依据 · 4 处
对象转换方法有不同职责

toString通常为对象提供文本表示,valueOf则可能提供更合适的原始值,也可能仍返回对象。普通对象、数组和Date可以采用不同实现;对象存在这些方法与调用后一定取得某种原始值并不是一回事。需要按返回结果而非方法名称判断转换是否完成。

对象转换方法有不同职责保存独立卡片。

原书依据 · 4 处
转换提示决定方法尝试顺序

按本书ES5普通对象转换路径,字符串提示先试toString再试valueOf,数值提示顺序相反;某一步得到原始值后,才继续转换到所需类型。若两步都无法给出原始值则抛出TypeError。方法可被覆盖并执行代码,因此隐式转换不是一个保证无副作用的纯文本处理;现代特殊转换钩子不在此历史路径的完整范围内。

转换提示决定方法尝试顺序保存独立卡片。

原书依据 · 3 处
空数组数值转换经过文本

按本节普通数组的默认转换,valueOf仍返回对象,后续toString使空数组得到空字符串,再转成数值0。单个数字元素的数组也可能经“数组文本—数值”得到对应数字。这是特定转换链的结果,不说明数组本身等于一个数,也不能据此认定任何单元素数组都能成为有效数值。

空数组数值转换经过文本保存独立卡片。

原书依据 · 1 处
Date默认转换与数值转换不同

本书Date在加法等默认原始值转换中偏向文本,减法却明确要求数值,因而now+1和now−1可能得到不同结果类型。相同对象面对不同运算符,不一定先走同一种转换。应先确定所需提示,再解释方法顺序和最终操作,不能把日期看作在所有位置都等同时间戳。

Date默认转换与数值转换不同保存独立卡片。

原书依据 · 1 处

3.9 变量声明

var可只声明,也可连同初始化表达式;声明并不为变量指定固定值类型。初次声明未提供初始化的var可读到undefined,而后续赋不同类型值仍属于同一个绑定的变化。

变量名与所存值分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

var声明与初始化分工

var可以声明一个或多个绑定,也可附上初始化表达式。声明使名字在相应作用域参与解析,初始化赋予具体值;第一次建立而未赋值的var通常得到undefined。不要把同一绑定的重复声明误看作每次都会重新清空其已有值,赋值的执行时点仍应单独判断。

var声明与初始化分工保存独立卡片。

原书依据 · 2 处

重复的声明和遗漏的声明

同一var绑定可重复声明,但初始化器依旧执行;遗漏声明的赋值在严格与非严格模式下可能走不同路径。若外层已有同名绑定,则赋值会修改它,不能把所有漏var都概括成创建新全局。

遗漏声明会改变赋值责任

按本书传统非严格脚本,给解析不到的名字赋值可能在全局对象上创建属性,而严格模式会报错;若原本能解析到外层绑定,则会修改外层值。遗漏声明并不是可靠的局部变量创建方式。重复var也不意味着其初始化表达式没有副作用,声明与实际赋值仍应分开追踪。

遗漏声明会改变赋值责任保存独立卡片。

原书依据 · 1 处

3.10 变量作用域

词法嵌套决定局部名字可见范围,内层同名绑定遮蔽外层。赋值若没有建立新的局部绑定,可能沿查找链修改已有外层状态,原书checkscope2用两个名字说明修改与意外创建的差别。

局部绑定遮蔽外层同名值

函数参数和局部声明参与该函数的词法作用域,内层存在同名绑定时优先解析它。若只写赋值而没有建立局部绑定,操作可能沿外层链找到并修改已有变量。遮蔽与修改外层状态是不同动作,判断副作用要先确认名字究竟解析到哪里。

局部绑定遮蔽外层同名值保存独立卡片。

原书依据 · 1 处

3.10.1 函数作用域和声明提前

var按函数作用域建立绑定,赋值仍在语句实际执行时发生。例子中局部scope在第一次console读取时已遮蔽外层,但值仍为undefined。这里的提前是理解绑定建立的语义方式,不要求引擎真的移动源文件,也不包含后来所有声明形式。

函数作用域下的声明提前机制

在本书函数内的var语境,绑定在函数执行前已建立,初始化赋值仍到原语句位置才执行。因此局部var scope虽写在console之后,也会先遮蔽外层scope,初次读取可得到undefined。if/for花括号不为var新建独立块作用域;这不等于JavaScript永远没有块级绑定,也不等于源码必须真的被挪动到顶部。

函数作用域下的声明提前机制保存独立卡片。

原书依据 · 2 处

3.10.2 作为属性的变量

传统非严格全局脚本中,声明变量与直接创建全局对象属性可有不同属性特征,因此删除行为不同。局部环境记录则是规范使用的抽象,不应想象为程序可任意枚举或通过this访问的普通对象。

全局声明不同于直接写属性

本书传统非严格脚本中新建的全局var与对不存在名字直接赋值,可能形成具有不同可配置性的全局对象属性,因而delete行为不同。这个例子必须保留脚本、声明及严格模式前提,不能推广到模块或所有顶层绑定。把某个值放到全局对象也不等于建立与所有语言声明完全相同的绑定。

全局声明不同于直接写属性保存独立卡片。

原书依据 · 2 处

3.10.3 作用域链

作用域链按词法包含关系组织名字查找,函数保留定义环境,每次调用又拥有新的局部状态。它不是按调用者临时搜索,也不要求实现把局部变量存成普通可见对象。脚注介绍的动静态类型与提升讲义属于补充,需要与可观察语义分开。

作用域链是变量解析的查找链

名字解析从当前词法环境向外查找,较近的同名绑定会遮蔽较远者;普通未解析标识符读取最终可能抛ReferenceError。函数保留定义时的外层环境,每次调用又建立本次局部状态,所以同一段嵌套函数代码可关联不同调用实例。作用域链是语义理解模型,不保证每层就是程序可见的普通对象,也不等于沿运行时调用者查找。

作用域链是变量解析的查找链保存独立卡片。

原书依据 · 3 处
类型检查不等于显式类型标注

动态类型与静态类型的区别主要关乎何时及怎样检查值的使用是否合法,不是名字有没有类型注释这一件事。JavaScript示例允许同一变量先保存数字再保存字符串,但每个值仍有自身类型。静态系统也可以推断类型,因此不能沿用脚注“所有变量都必须手工声明类型”的绝对化;判断应回到具体语言的检查规则。

类型检查不等于显式类型标注保存独立卡片。

原书依据 · 1 处

第4章 表达式和运算符

表达式从简单值与名称组合而来,属性访问、调用和运算又把子表达式的结果继续用于较大计算。求值获得结果不排除副作用;本章进一步区分语法结构、类型转换和真正的执行顺序。

表达式可以产生副作用关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

4.1 原始表达式

常量、名字和this可作为基础表达式组成更复杂计算,但它们取得值的机制不同:字面量直接给出,名字经过解析,this依执行上下文。原书把非严格读取不存在名字说成undefined,是与普通名字解析规则不符的表述。

未解析名字不同于缺失属性

读取一个普通未解析标识符会抛出ReferenceError,并非只有严格模式才会报错;已声明但值为undefined、或读取不存在的对象属性,是不同情况。typeof对未解析名字有特殊处理,也不能把这个例外推广到一般读取。排查“没有值”时,应先分清名字绑定与对象成员这两个层次。

未解析名字不同于缺失属性保存独立卡片。

原书依据 · 1 处

4.2 对象和数组的初始化表达式

对象和数组字面量会求值其成员表达式,并创建新的外层对象,嵌套表达式可继续创建结构。数组中省略元素形成空槽,不能说已经创建了几个值为undefined的自有元素。

字面量求值创建新外层对象

对象或数组字面量每次求值会创建新的外层对象,并计算成员初始化表达式。成员不是只能写常量,也可引用其他值或继续嵌套字面量。两个外观相同的字面量结果不因此共享对象身份;若成员表达式取得已有对象引用,该成员仍可共享那个内部对象。

字面量求值创建新外层对象保存独立卡片。

原书依据 · 1 处

空槽不同于存入未定义值

数组字面量中的连续逗号可以省略位置,形成空槽;本节[1,,,,5]的长度为5,但不等于已经存入五个自有元素。空槽读取常见结果是undefined,却与显式保存undefined不同,还涉及原型查找及后续遍历规则。末尾一个分隔逗号不自动再增加一项,不能只数可见逗号判断内容。

空槽不同于存入未定义值保存独立卡片。

原书依据 · 3 处

4.3 函数定义表达式

函数表达式求值得到一个函数对象,可赋给变量并在之后调用。定义与调用是两个不同时间点,表达式还可携带函数自身的名字,不应混同接收它的变量名。

函数值可保存与组合关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

4.4 属性访问表达式

属性访问先取得基值,再决定按固定名字还是计算出来的键查找。null和undefined不能按普通属性访问处理,缺失属性与基值缺失也不同。原书保留字必须方括号的说法不能无条件应用于ES5属性名语法。

固定属性名与计算属性键分开

点号后的名称直接指定属性,方括号内则先计算表达式,再按相应键规则访问,适合动态名字、空格名称或数组索引。本书ES5语境以字符串键解释,但不能把它推广为今日所有属性键的唯一类型;保留字也不总要求方括号,仍须核对目标版本的属性名语法。

固定属性名与计算属性键分开保存独立卡片。

原书依据 · 2 处

成员访问先确认基值

访问o.x或o[key]之前要先取得o,若它是null或undefined,普通成员访问会产生TypeError。若o是可访问对象而属性没有找到,才通常得到undefined;这与基值本身不存在不是同一种情况。原始值的包装行为也不意味着可以把任何缺失值当成空对象。

成员访问先确认基值保存独立卡片。

原书依据 · 1 处

4.5 调用表达式

调用先取得目标并计算参数,再执行可调用行为;返回值成为调用表达式结果。普通方法调用把基对象提供为接收者,而普通函数调用的this处理还受严格模式等调用约定影响。

方法调用给出接收对象关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

调用先求目标与参数

函数调用表达式先求出目标,再计算实参表达式,之后才进入目标行为;目标不可调用时会产生TypeError。参数表达式本身可以有副作用或抛错,所以“调用失败”不代表此前没有执行任何代码。正常函数未明确返回值时,调用结果为undefined;构造调用另有返回值规则。

调用先求目标与参数保存独立卡片。

原书依据 · 1 处

4.6 对象创建表达式

new把创建对象与初始化调用组合起来,但构造函数的返回值可能改变最终结果。通常使用新对象作为this完成初始化;若明确返回另一个对象,则那个对象成为new表达式的结果。

构造返回对象可替换新实例

本书普通构造调用会先准备新对象,再把它作为this调用构造函数。若构造函数返回对象,该返回对象可成为整个new表达式的结果;返回原始值则不以同样方式替换实例。这说明构造函数不是被语法禁止return,初始化对象与最终得到的对象也不总是同一份。

构造返回对象可替换新实例保存独立卡片。

原书依据 · 2 处

4.7 运算符概述

运算符表按优先级排列,并把结合性、操作数个数及输入输出类型分列。关键字形式与标点形式都可能是运算符;表是理解后续细节的索引,不是通过符号外观判断执行机制。图表00011已完整查看。

运算符表需分开四种维度

阅读运算符表时,要分开四个问题:怎样分组决定优先级,同级表达式怎样结合,需几个操作数,接受及产生什么类型。关键字delete、typeof等与标点形式一样可承担运算职责。知道符号对应什么名称只是入口,不能替代对转换、短路和副作用的具体解释。

运算符表需分开四种维度保存独立卡片。

原书依据 · 1 处

4.7.1 操作数的个数

一元、二元和三元描述运算符连接多少个操作数,并非运算“难度”或返回多少值。同一个符号可以因位置不同而承担不同操作,比如一元负号与二元减法。

操作数个数描述表达式形状

一元运算符处理一个操作数,如−x;二元运算符组合两个操作数,如x*y;条件运算符?:在语法上连接条件及两个备选表达式。这个分类描述语法结构,不保证所有备选都被求值,也不是按结果数量分类。相同的减号字符可以在一元与二元位置表达不同操作。

操作数个数描述表达式形状保存独立卡片。

原书依据 · 1 处

4.7.2 操作数类型和结果类型

运算符的输入要求可能触发转换,而结果类型又是另一项约定。同一个加号或比较符号可根据转换后的值采取不同含义,不能看到两个字符串就认为结果必然也是字符串。

运算符含义依赖操作数关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

4.7.3 左值

左值表示可作为赋值目标的位置或引用,不是“只能在左边出现”。变量和成员位置也可以在其他表达式中被读取;此外能形成目标不保证对象属性实际可写。

左值是赋值目标而非专属位置

“左值”用于说明表达式可以指向某个赋值目标,例如变量、对象属性或数组元素;这些表达式同样可以出现在右侧被读取,不是只准写在等号左边。合法目标还要结合实际可写性与执行模式判断。普通自定义函数返回的值也不会因此自动成为可对调用结果赋值的变量位置。

左值是赋值目标而非专属位置保存独立卡片。

原书依据 · 1 处

4.7.4 运算符的副作用

赋值、自增和删除显式改变状态,调用与转换则可能执行进一步代码。不能把非赋值运算符一概判为无副作用;删除属性也不等于仅把属性值设成undefined。

表达式可以产生副作用关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处
删除属性不同于清空属性值

delete尝试移除属性本身,给属性赋undefined通常只改变该属性保存的值,二者的存在性与后续查找可能不同。删除还会受属性可配置性和执行模式约束。把二者当同一动作,容易在检测成员、继承查找或遍历时得到意外结果。

删除属性不同于清空属性值保存独立卡片。

原书依据 · 4 处

4.7.5 运算符优先级

优先级主要规定表达式怎样组合,括号可以使组合关系明确;这不同于所有子表达式的求值时间次序。x+y*z的乘法结果参与加法,但不表示表达式x一定在y和z之后才求值。

优先级先决定表达式分组

优先级使x+y*z按x+(y*z)分组,括号又能改成(x+y)*z。它回答“哪个运算结果作为谁的操作数”,不能直接替代对各子表达式何时求值的说明。不确定分组时可用括号显露意图,也应保留赋值、调用及属性访问各自的规则。

优先级先决定表达式分组保存独立卡片。

原书依据 · 1 处

4.7.6 运算符的结合性

同等优先级运算连续出现时,还需结合性确定分组。左结合减法与右结合赋值、条件表达式产生不同结构,不能把结合性看成所有实参和分支都按那个方向求值。

结合性解决同级运算分组

左结合使x−y−z按(x−y)−z解释,右结合使连续赋值按w=(x=(y=z))组织。结合性解决同级运算的分组,不等于数学上可任意换括号,也不直接决定所有子表达式的副作用顺序。连续条件表达式同样需要看清分支结构,必要时用括号说明。

结合性解决同级运算分组保存独立卡片。

原书依据 · 1 处

4.7.7 运算顺序

子表达式的求值顺序与运算结果的组合关系分开。在本节赋值例中,先确定左侧目标,再依规定求右侧子表达式,最后使用乘法、加法结果完成赋值;若子表达式会改状态,观察到的值取决于这种顺序。

求值顺序不能由括号方向推断

在w=x+y*z中,求取赋值目标和各操作数的顺序,与先把y*z组合成乘法结果是不同层次。某个操作数如果修改了后续会读取的状态,求值顺序就会影响结果;括号改变分组不能任意倒置这些规定的求值步骤。也不能把本例推广为所有条件或短路分支都会被求值。

求值顺序不能由括号方向推断保存独立卡片。

原书依据 · 1 处

4.8 算术表达式

本节算术按Number语境处理:乘除减及求余通常会先数值转换,结果仍可能是NaN或无穷。除法不会因为两个操作数写成整数就自动截断;求余的符号规则也不同于许多数学模的惯用定义。

数值除法不自动截断

按Number运算,5/2得到2.5而非截断到2,乘、除、减及求余会按相应数值规则处理可转换操作数。除零和无效结果可能成为带符号无穷或NaN,不一定以异常报告。这里的规则带有Number前提,不能把它复制为其他数值类型或所有现代算术的共同契约。

数值除法不自动截断保存独立卡片。

原书依据 · 1 处

求余符号跟随被除数

Number的%表示除法余数,本节5%2为1而−5%2为−1,结果符号跟随被除数。它不等于所有数学语境中要求非负的模运算。浮点数也可参与,但原书6.5%2.1写成0.2只应作为近似数学结果阅读,二进制表示仍有舍入。

求余符号跟随被除数保存独立卡片。

原书依据 · 1 处

4.8.1 “+”运算符

加号先把对象转换为原始值,再依据是否出现字符串选择连接或数值加法。结合分组会改变何时先形成字符串;原书若干输出注释额外加入了源码中没有的空格,需要按实际输入理解。

加号先转换再选择连接或加法

按本书ES5规则,二元加号先取得原始值;若其中一个是字符串,就把另一值也转为字符串并连接,否则转为数值再相加。因此true+true可进行数值计算,”1”+2则连接文本。结合分组可能使数值先相加或先变成字符串,源码没有空格时输出也不会自动插入空格。

加号先转换再选择连接或加法保存独立卡片。

原书依据 · 1 处

4.8.2 一元算术运算符

一元加减处理数值转换及符号,递增递减还要写回目标;前后缀区别在表达式取旧值还是新值。自增不是简单字符串拼接,后缀与操作数也有不能换行的语法边界。

一元正负号先做数值转换

在本书Number语境,一元加号取得数值转换结果,一元减号再改变其符号;这与二元加号可能连接字符串不同。转换失败可能得到NaN,符号还可能保留带符号零。不要把一个符号在不同操作数个数中的含义混在一起。

一元正负号先做数值转换保存独立卡片。

原书依据 · 1 处
自增返回旧新值但都会写回

前缀++先更新目标并提供新值,后缀++同样更新目标却提供更新前的值,递减规则对应。示例中++i可使i和接收结果的j都为2,i++则使i为2而j为1。操作需要赋值目标,并在本书语境先进行数值转换,不等同字符串x加1;后缀不得与操作数分到两行。

自增返回旧新值但都会写回保存独立卡片。

原书依据 · 2 处

4.8.3 位运算符

Number位运算采用32位转换,并对移位量取低5位。与或异或非处理位值,三种移位又按截断与补位方式产生不同结果。原书允许跳过的建议不作为本轮略读依据;本节已完整读取。

位运算先采用32位数值视图

本书Number位运算先把值转换到32位整数视图,小数部分和范围外高位不被保留;NaN与无穷在这类转换中得到0。移位量经过无符号转换后只取低5位,因此有效位数为0到31,并不表示输入一超出该范围就必定报错。这些是特定数值运算规则,不是把原变量永久变成某种存储类型。

位运算先采用32位数值视图保存独立卡片。

原书依据 · 1 处
按位逻辑组合二进制标记

按位与只保留两边都为1的位置,按位或保留至少一边为1的位置,异或保留不同的位置,按位非则逐位翻转。原书0x1234与0x00FF相与得到0x0034,展示了掩码选取低位的用途。~x与−x−1的关系需放在相应32位解释中,不能推广到任意原始Number值;原文异或段落的符号应为^。

按位逻辑组合二进制标记保存独立卡片。

原书依据 · 1 处
三种移位采用不同补位规则

左移在低位补0并截去高位,带符号右移>>以原符号补高位,无符号右移>>>总在高位补0。例子−7>>1为−4,不能用朝零截断的除法解释;左移乘2的类比也要保留32位溢出边界。−1经>>仍可为−1,经>>>则得到非负的无符号结果。

三种移位采用不同补位规则保存独立卡片。

原书依据 · 1 处

4.9 关系表达式

本节转向用布尔结果描述值之间的关系,包括相等、大小、成员存在和原型判断。返回布尔值不代表这些运算执行同一套类型转换,仍需分别读后续算法。

4.9.1 相等和不等运算符

相等与严格相等的转换条件不同,对象身份比较又与内容相同比较分开。原书严格相等列表把两个null或两个undefined说成不相等,是明确错误;已以ES5.1严格比较算法核对校正。

严格相等保留本类型比较规则

严格相等不进行跨类型转换:类型不同会不相等,同为null或同为undefined则相等。NaN仍不等于自身,正负零相等;字符串按码元序列,对象按身份。原书把同为null或undefined写成不相等,与规范相反,不能沿用。严格相等不是把所有类型都转换成文本,也不是对象深比较。

严格相等保留本类型比较规则保存独立卡片。

原书依据 · 2 处
宽松相等按类型分支转换

宽松相等先看双方类型,可能把布尔转成数值、字符串转成数值,或把对象转成原始值后继续比较。原书”1”==true可经两次转换得到同一数值;null与undefined还有专门关系。不能把它简化成统一转布尔或统一转字符串,更不能把赋值号=当成比较。

宽松相等按类型分支转换保存独立卡片。

原书依据 · 1 处

4.9.2 比较运算符

大小比较按转换后的两个值处理:同为字符串时用码元顺序,否则在本书语境中倾向数值比较。码元顺序不等于自然语言排序,NaN又使四种比较都为假,不能把<=解释成简单调用==。原书>=分支写两次false,以及localCompare拼写均有误。

关系比较先确定文本还是数值

按本书规则,比较先把对象转成原始值,两个字符串以码元序列顺序比较,否则转成数值比较。因此”11”与”3”的顺序可不同于数字11与3。若有NaN,四种大小比较都得到false;<=和>=不靠拼上==来实现,不能由一次比较为假就反推出另一关系为真。

关系比较先确定文本还是数值保存独立卡片。

原书依据 · 1 处
码元排序不同于语言排序

字符串的关系运算比较码元序列,ASCII大写字母整体排在小写字母之前,因此”Zoo”可排在”aardvark”之前。这不是自然语言排序或无条件的不区分大小写比较。需要语言相关次序时应核对localeCompare等接口及实际语言规则,不能只把所有文本转小写就宣称解决全部本地化比较。

localeCompare的返回值只按负、零、正判断,不保证固定为-1或1;排序规则可能把不同文本视为同等。需要稳定业务比较应明确地区和选项,不能将原书某语言历史排序例当所有现代地区规则。

码元排序不同于语言排序保存独立卡片。

原书依据 · 2 处

4.9.3 in运算符

in检测属性名是否能在对象及其原型链上找到,数组也按索引属性名判断,不按元素值判断。右侧对象要求与普通属性访问的包装语义还不同。

in检查属性名而非元素值

in测试对象是否具有某个属性名,包含原型链上的继承属性;它不是只检查自有属性。对数组,1 in data检查索引”1”是否存在,不是询问值1是否在数组里。右侧需要对象,不能把普通成员访问对某些原始值的包装行为直接套到in;属性存在也不代表其值一定非undefined。

in检查属性名而非元素值保存独立卡片。

原书依据 · 1 处

4.9.4 instanceof运算符

本书普通instanceof通过构造函数prototype与对象原型链的关系判断,而不只是查“是否曾由这个函数创建”。原文把查找方向写反,所有对象都是Object实例的概括也不成立;需要保留原型链与环境前提。

原型链关系决定实例判断

在本书普通instanceof语境,判断o instanceof f时,是看f.prototype是否出现在o的原型链上,不是在f的链里查找o。这是当前原型关系判断,不是创建历史证明。原型可不同或被改变,因此例子中Date和数组也属于Object的情况,不能推广成任意对象和跨环境对象都必定满足同一个Object判断。

原型链关系决定实例判断保存独立卡片。

原书依据 · 1 处

4.10 逻辑表达式

逻辑运算将真假判断组合,但&&和||还可能提供原操作数并跳过另一边求值,!则直接产生布尔结果。接下来按这三种机制分别解释。

4.10.1 逻辑与(&&)

&&先计算左侧,左侧为假直接返回它,为真才计算并返回右侧。这样可以在已知值域下保护后续成员访问,也会使右侧副作用是否发生依赖左侧结果。

逻辑与或可以返回操作数关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处
短路与按条件读取右侧

&&先求左操作数,若是假值直接返回该值,否则求并返回右操作数。原书p为null时,p&&p.x返回null且不访问p.x;这不同于先读属性再判断。它也会筛掉0或空字符串等其他假值,右侧调用是否发生取决于左侧结果,不能把短写形式当成无条件执行的两步。

短路与按条件读取右侧保存独立卡片。

原书依据 · 1 处

4.10.2 逻辑或(||)

||选择第一个真值,若左侧为假才求右侧。默认值惯用法由此产生,也可能错误覆盖合法0、false或空字符串;“已经定义”与“真值”不能混同。

默认值或会覆盖合法假值

||先求左值,为真就返回它,否则求右值并返回。用于默认值时,它选择第一个真值,不是只选择第一个“已声明”或“非缺失”值。原书宽度例若0是合法输入,也会被替换;若名字本来未解析,||更不会先替它消除读取错误。默认规则必须与允许值域一致。

默认值或会覆盖合法假值保存独立卡片。

原书依据 · 4 处

4.10.3 逻辑非(!)

!先取真假再反转,两次!得到对应布尔值。反转一个组合时要明确括号,等式检验中的右侧逻辑组合也必须分组,避免严格相等优先级改变想表达的命题。

反转组合需同时换逻辑连接

否定“p并且q”等价于“非p或者非q”,否定“p或者q”等价于“非p并且非q”,这里两边最终均为布尔结果。若在JavaScript中用===检查这种关系,需明确比较对象,例如把右侧写成(!p||!q)的整体。原书未给比较右侧加括号的代码不能直接作为这两个逻辑恒等式的通用可执行检验。

反转组合需同时换逻辑连接保存独立卡片。

原书依据 · 1 处

4.11 赋值表达式

赋值既写入目标,又提供右侧的值,所以可以出现在更大表达式或连续赋值中。这两个职责要同时追踪,不能把=与比较符混用。

赋值表达式还提供被赋的值

赋值表达式把值写到左侧目标,同时以右侧值作为自身结果。因此可以写连续赋值,也可在括号中把赋值结果继续用于比较。右结合描述各赋值如何嵌套,不代表复杂目标与右值表达式都可任意倒置求值;目标可写性与模式错误仍须另外处理。

赋值表达式还提供被赋的值保存独立卡片。

原书依据 · 1 处

带操作的赋值运算

复合赋值把读取当前值、执行运算与写回合并,关键是左侧目标只求值一次。若把它机械展开,带自增的索引可能被求值两遍,所读所写甚至不是同一位置。表00012已实际查看。

复合赋值只定位目标一次

a op= b把当前目标值用于运算并写回,而目标定位只进行一次。对简单变量,常可与a=a op b对照理解;若目标包含data[i++]等副作用,直接展开会两次计算索引,改变读取和写入对象。+=也继承加法的数值或连接规则,不必然是纯数字累加。

复合赋值只定位目标一次保存独立卡片。

原书依据 · 1 处

4.12 表达式计算

eval把字符串作为代码解析执行,所以它与普通数据转换不同,也让依赖固定词法绑定的分析更复杂。需要区分语言规定的作用域行为与某引擎的优化策略,不能把原书“完全不能优化”当成所有实现的定律。

动态代码执行增加分析边界

eval可把字符串当作JavaScript代码,而不只是数据,动态名称访问会使静态分析与优化更困难。具体引擎能做何种优化仍由实现决定,不能笼统说调用它的函数永远无法优化。采用这种能力前应先确认确有动态执行需要,也不能把不可信内容当作普通参数数据放心交给代码解释入口。

动态代码执行增加分析边界保存独立卡片。

原书依据 · 1 处

4.12.1 eval()

eval的字符串必须作为合法的eval代码解析,解析失败和执行失败属于不同阶段。直接调用还可使用调用点词法环境,但不能把传入文本当作调用函数体中任意粘贴的片段。

eval代码需独立满足语法

内置eval对非字符串参数直接提供该值,对字符串则先解析再执行。语法不合法可产生SyntaxError,执行期间异常也会向调用者传播。即使从函数内直接调用,eval(“return;”)也不能成为外层函数的返回语句,因为eval代码不是任意插入的函数体片段;原因不应被误写成该调用自动变为全局eval。

eval代码需独立满足语法保存独立卡片。

原书依据 · 2 处
eval结果取决于语句完成值

eval可以提供所执行代码的语句完成结果,没有相应值时可得到undefined。不能把它当作给每个脚本末尾自动加return,也不能简单由最后一个语句表面有没有值推定全部结果;语句列表中的完成值传播有独立规则。需要普通参数化计算时,明确函数接口通常比依赖动态代码完成值更易理解。

eval结果取决于语句完成值保存独立卡片。

原书依据 · 2 处

4.12.2 全局eval()

ES5把直接eval与间接调用分开:前者满足特定调用形式并调用内置eval,才可使用调用点的词法环境;别名等间接调用按全局环境执行。它们影响能接触的绑定,不代表后者是安全沙箱。

直接与间接eval使用不同环境

直接eval是在符合该特殊形式并确实调用内置eval时,使用调用位置的词法环境;给它别名后间接调用,按本书ES5规则转到全局环境,不能直接读写调用者局部绑定。名字恰好叫eval但已被另一个函数遮蔽时,也不能仅凭拼写认定获得这种语义。间接执行仍可接触全局能力,不等于隔离不可信代码。

直接与间接eval使用不同环境保存独立卡片。

原书依据 · 2 处

4.12.3 严格eval()

严格eval把自身新增声明限制在独立环境,不把声明泄漏到外层。必须再区分直接和间接调用:间接eval不因调用者严格就自动继承局部环境;eval这个名字的绑定限制也不等于禁止建立任意别名。

严格eval隔离新增声明

严格的eval代码有自己的声明环境,不能把新var或函数声明注入调用者作用域;直接eval仍可能访问并修改可见外层绑定。严格调用者的限制与间接eval的全局入口需分别判断,间接调用不自动获得调用者局部环境。这里限制的是声明泄漏,不表示所有外层状态都被冻结。

严格eval隔离新增声明保存独立卡片。

原书依据 · 2 处
eval绑定限制不等于禁止别名

严格模式限制将eval用作某些绑定名或赋值目标,但它并非因此成为不能在任何位置出现的普通保留字。保存内置eval的别名与覆盖名为eval的绑定是不同动作,别名调用还会采用间接eval语义。应分开名称限制、实际函数身份和调用形式,不能只按“是否有另一个名字”判断。

eval绑定限制不等于禁止别名保存独立卡片。

原书依据 · 1 处

4.13 其他运算符

最后几种运算分别负责条件选择、类型观察、属性删除、丢弃结果及顺序组合,下面逐项展开。

4.13.1 条件运算符(?:)

条件运算符先判断条件真假,只求值一个备选并提供该值。它能把选择放进更大表达式,但“有定义”仍不应被混同真值,合法0或空文本可能需要另一种条件。

条件表达式只计算选中分支

条件运算符?:先计算条件并判断真假,再只计算第二或第三个表达式之一,返回所选结果。因此未选分支的副作用不会发生,且结果不必是布尔值。用于默认值时仍要先决定条件是“真值”还是“非缺失”,不能只因变量已声明就认定会选到它。

条件表达式只计算选中分支保存独立卡片。

原书依据 · 1 处

4.13.2 typeof运算符

typeof提供粗粒度类型字符串,不能替代全部对象分类。表00013已实读,null结果与可调用对象的历史差异尤其要区分;它是运算符而非必须调用的函数。

typeof不提供完整对象分类

typeof对本书常见值给出类型字符串,但null也得到”object”,普通数组与许多对象同样得到”object”,NaN仍属于Number。它能辅助粗分类,不能证明某值非null、是数组或满足具体对象接口。表中宿主与浏览器差异属于历史背景,不应把ES5列表当作当前语言所有可能结果。

typeof不提供完整对象分类保存独立卡片。

原书依据 · 1 处

4.13.3 delete运算符

delete作用于属性存在性,删除数组索引会形成空槽而不自动缩短length。它也返回布尔结果:不存在属性仍可返回true,失败时的false与严格模式异常要分开;原书开头说它不用来返回值不应理解为没有结果。

删除属性不同于清空属性值关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处
删除结果不证明曾有属性

delete返回true不证明实际移除了一个原有属性:删除原本不存在的属性也可成功,删除某个自有属性后还可能继续看到继承属性。不可配置属性的删除,在非严格模式可返回false,在严格模式可抛TypeError;严格模式对裸绑定名还有语法限制。结果必须结合目标和模式解释,不能简单当成“刚删了一个对象”。

删除结果不证明曾有属性保存独立卡片。

原书依据 · 1 处

4.13.4 void运算符

void仍然求值其操作数,只把表达式结果替换为undefined。因此它可以保留副作用,不能用来跳过或抑制可能抛错的计算。

void丢弃结果但仍执行求值

void先计算操作数,再提供undefined,因此调用、赋值或异常等求值行为不会被它取消。它表达“不使用这个结果”,不是“不执行这段代码”。原书javascript:链接展示的是历史客户端用法,事件注册可更清楚地区分导航与点击行为,不能把void当作异常处理或安全过滤。

void丢弃结果但仍执行求值保存独立卡片。

原书依据 · 1 处

4.13.5 逗号运算符(,)

逗号运算符依次计算左右并提供右侧值,而声明列表及参数列表中的逗号可能只是语法分隔。脚注用后缀自增再次解释立即更新和取旧值的分工,不能把后缀理解成到整个表达式末尾才更新。

自增返回旧新值但都会写回关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处
逗号运算提供最后的值

逗号运算符先求左侧再求右侧,丢弃左值并提供右值,左侧副作用仍会发生。本节for更新部分用它组合i++与j–,而var i=0,j=10中的逗号只是声明分隔,不是同一个运算。两个位置外观相同,必须按所在语法和需要的结果来理解。

逗号运算提供最后的值保存独立卡片。

原书依据 · 1 处

第5章 语句

语句把表达式求值、声明和控制流组成可执行程序。默认顺序可以被条件、循环和跳转改变;语句可以内含其他语句,分号也并非所有结构的统一结尾。表达式仍可有副作用,不能把“表达式有值、语句做事”当绝对二分。

语句组织程序动作与路径

语句与声明把值计算组织成程序:表达式语句可执行赋值或调用,条件选择路径,循环重复执行,跳转改变接下来的控制位置。不是所有语句都必须产生可见副作用,也不是所有语法结构都以分号结束;理解程序要同时看结果计算与控制流。

语句组织程序动作与路径保存独立卡片。

原书依据 · 1 处

5.1 表达式语句

表达式可以在语句位置求值,常见用途是保留赋值或调用的副作用。若希望以后使用计算结果,需要把它保存或继续组合;单纯丢弃返回值与函数不执行是两回事。

表达式语句可丢弃计算结果

函数调用既可作为单独表达式语句,也可把结果赋给变量或用于更大表达式。独立写Math.cos(x)仍会求值,只是普通后续代码没有保存其结果;赋给cx才能便于以后读取。是否值得这样使用取决于要保留副作用还是结果,不能把返回值未使用理解为调用不会发生。

表达式语句可丢弃计算结果保存独立卡片。

原书依据 · 1 处

5.2 复合语句和空语句

语句块把多个动作放进语法上的一个语句位置,空语句则以一个分号占位。循环的工作可放在更新表达式里,但无意写在if后的分号会让后句脱离条件控制。var在块中的范围仍按它自己的声明规则判断。

语句块把多个动作作为一体

花括号块可让多个语句共同占据一个语句位置,例如让循环体或条件分支执行多步动作。缩进帮助阅读,但实际结构由语法决定。块本身是否形成某类绑定的作用域,还取决于声明形式;本书var没有因此获得块级私有范围,不等于现代所有声明都相同。

语句块把多个动作作为一体保存独立卡片。

原书依据 · 1 处

空语句会占据条件或循环体

单独分号是空语句,可有意作为空循环体,让工作都在循环更新表达式中完成。若误放在if条件之后,它也会成为该if控制的语句,下一句不再受该条件约束。空语句很短却改变结构,有意使用时应让意图可见,不能仅凭缩进推断控制范围。

空语句会占据条件或循环体保存独立卡片。

原书依据 · 1 处

5.3 声明语句

声明把名字与变量或函数建立联系,但绑定建立、函数创建和初始化表达式执行可能处于不同语义阶段。不能由“声明”二字就认定整条语句完全不执行任何计算。

5.3.1 var

var可以组合多个声明及初始化,初始化表达式还可使用较前已赋值的变量。局部或全局范围按所在代码语境而定,提升不把所有初始化也提前。

var声明与初始化分工关联本项背景,实质主要讲解在对应位置。

函数作用域下的声明提前机制关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

5.3.2 function

函数声明建立可调用绑定,但不在定义时运行函数体。它与把函数表达式赋给var的区别在于,函数声明的绑定和函数值会在相应环境建立时准备,表达式初始化则等语句执行;本书ES5的块内函数限制应作为历史语境阅读。

函数声明与表达式初始化不同

本书普通脚本或函数体中,函数声明可在相应环境建立时准备名字与函数值,所以代码写在后面也可能先调用。var f=function…只提前var绑定,函数表达式要到初始化执行时才取得值。提升不要求声明字面上必须是函数体第一行;ES5块内函数的可移植性问题也不能当成所有后来版本的规则。

函数声明与表达式初始化不同保存独立卡片。

原书依据 · 2 处
定义函数不执行函数体

函数定义把参数名、函数体与可调用对象关联,函数体中的普通动作要等调用才执行。花括号是函数定义语法的必需部分,不能因函数体只有一句就像某些控制语句一样省略。创建可调用行为与真正执行该行为是两个阶段,不应把声明位置当作调用次数。

定义函数不执行函数体保存独立卡片。

原书依据 · 2 处
递归计算要有终止路径

本节阶乘例在n<=1时提供基例,否则把问题缩小成n−1并再次调用自身,返回后组合结果。对所假设的非负整数范围,参数持续减小使计算能到达基例;函数写成递归并不自动验证所有输入,也不保证不会遇到数值或调用深度限制。需要同时说明缩小规则和停止条件。

递归计算要有终止路径保存独立卡片。

原书依据 · 4 处

5.4 条件语句

条件把正常顺序路径分成备选,if/else与switch提供不同表达形式。真正选择哪条路径还取决于条件的真假转换或匹配规则,下面按语法分别展开。

5.4.1 if

if根据条件真假选择一个语句或块,具体条件决定哪些值被归入同一类。嵌套时else匹配最近可配对的if,缩进不改变这个结构,花括号可把意图写清楚。

分支条件要对应允许的值域

判断username==null在本书普通规则下合并null与undefined,if(!username)却还包含false、0、空字符串及NaN。两种写法都能选择分支,但表达的缺失契约不同。应先决定哪些值有效,再选择条件;名字本身未声明的读取错误也不会由if自动消除。

分支条件要对应允许的值域保存独立卡片。

原书依据 · 2 处
else按语法匹配而非缩进

嵌套条件中,else与最近能够配对的if关联,视觉缩进不能改写关系。若希望else属于外层if,应使用块明确包住内层分支。这样既能让多条动作共同受条件控制,也能避免维护时新增一行改变或误读执行范围。

else按语法匹配而非缩进保存独立卡片。

原书依据 · 1 处

5.4.2 else if

else if是把另一个if放进前一条else中的惯用布局。条件依次检测,到选中分支后不再逐个继续选择,最终else处理前面均未命中的情况。

else if链依次选择分支

else if不是另一种独立的特殊关键字组合,而是嵌套if/else的清晰排版。条件按顺序尝试,前一项已命中时不会再选择后面的备选;最终else可承担全部未命中的情况。顺序因此是契约的一部分,重排条件并不保证行为不变。

else if链依次选择分支保存独立卡片。

原书依据 · 1 处

5.4.3 switch

switch先取得选择值,再按case表达式的严格相等关系寻找入口;default处理未匹配情况。入口只决定从哪里开始,break、return等才决定是否提前退出后续语句。原书说与使用==的if链等价需保留输入类型条件。

switch匹配采用严格相等

switch对选择表达式求值后,按case值进行严格相等匹配,不自动把数字字符串转为数字。它适合围绕同一选择值组织备选,但不能不加条件地替换使用==比较的if链。没有匹配且没有default时跳过整个结构,default的文字位置也不要求只能在最后。

switch匹配采用严格相等保存独立卡片。

原书依据 · 1 处
case起点与退出边界分开

case匹配决定执行起点,不会自动在下一标签处停止。正常执行缺少break时可能继续进入后续语句,return则会离开整个函数而不只是switch。连续标签有时可有意共享代码,退出方式必须按所需范围选择。

结构图:

flowchart TD
 A[求选择值并寻找case或default] --> B[从选中标签开始]
 A -->|没有入口| G[结束switch]
 B --> C[执行当前语句段]
 C --> D{遇到退出或末尾}
 D -->|是| G
 D -->|否| E[继续后续语句段]
 E --> C

case起点与退出边界分开保存独立卡片。

原书依据 · 1 处
case匹配表达式未必全执行

寻找switch入口时,后面的case表达式可能因较早匹配而不再求值。若在这些表达式中放调用或赋值,就会使副作用依赖匹配过程。进入后续语句段也不意味着重新对每个标签作一次匹配;将稳定的比较值与需要执行的动作分开,更容易看清行为。

case匹配表达式未必全执行保存独立卡片。

原书依据 · 1 处

5.5 循环

循环让控制流沿某条路径反复执行;本书介绍while、do/while、for和for/in四种历史基础形式。它们的测试时间、更新位置与遍历对象不同,不能只因都叫循环就互换。

5.5.1 while

while先判断条件,再决定是否执行一次循环体,正常体结束后重新判断。用于终止的状态必须有可解释变化;条件恒真本身不终止,但仍可能通过跳转退出。

while先测试再执行循环体

while在每轮开始判断条件,初始为假时可一次也不执行;为真时执行循环体,再回到条件。计数例通过更新count使条件最终变假,需要把初始化、状态变化与停止条件连接起来。while(true)没有靠该条件自然结束的路径,但仍可由break、return或异常等控制转移退出。

while先测试再执行循环体保存独立卡片。

原书依据 · 1 处

5.5.2 do/while

do/while进入后先执行体,再检测条件,适合需要先尝试一次的结构。示例仍先在外层判断空数组,所以不能从do体至少一次推断整个函数对空输入也必定访问元素。

do循环先执行再测试

进入do/while语句后,先执行一次循环体,再测试是否继续,因此它与初始条件可能为假而跳过的while不同。原书printArray在外面先检查空数组,避免把“循环体至少一次”误用到没有可读元素的输入。语法以do标开始,在后面的while条件后用分号收束。

do循环先执行再测试保存独立卡片。

原书依据 · 1 处

5.5.3 for

for将初始化、条件和更新位置放到同一结构中,三者可省略但分隔分号仍在。循环变量不必是数值,链表例以next引用推进;与while的对照需要留意continue等控制转移的差异。

for显露初始化测试与更新

for把初始化、每轮前测试与轮后更新放到同一语法中,正常路径按这些责任组织循环。更新不必是自增,初始化和更新也可省略;两个分号仍用于分开位置。与普通while展开对照时,应留意continue怎样进入更新位置,不能用机械移动文本保证所有控制流都等价。

for显露初始化测试与更新保存独立卡片。

原书依据 · 1 处
遍历推进不必依赖数值计数

本节链表例用当前节点的next推进,说明循环状态也可以是对象引用。它依赖输入节点有效及链能到达next为假值的尾节点;空输入或环形链不由这段简单代码自动处理。条件中省略测试与恒真相似,但仍应另说明退出或终止责任。

遍历推进不必依赖数值计数保存独立卡片。

原书依据 · 1 处

5.5.4 for/in

for/in枚举的是可枚举属性名,包含满足条件的继承属性,并不直接提供属性值。示例for(a[i++] in o)向数组收集名字,原文称复制所有属性容易误解;枚举顺序及期间修改的规则还带版本和对象条件。

属性枚举先取得名字再读值

for/in把枚举到的属性名交给每轮目标,读取o[p]才得到相应值。示例for(a[i++] in o)收集的是键名,并非把对象的属性和值一起复制到数组。目标表达式每轮会重新定位,因此其中的副作用也要追踪;数组参与枚举时得到的仍是属性名。

属性枚举先取得名字再读值保存独立卡片。

原书依据 · 1 处
for in包含可枚举继承属性

for/in不遍历所有属性,也不只遍历自有属性:它关注可枚举的字符串属性,原型链中满足条件的成员也可能出现。继承与可枚举是两项不同特征,不能说继承属性自动都可枚举。它因此不同于按0到length逐项访问数组,也可能遇到额外命名成员与空槽差异。

for in包含可枚举继承属性保存独立卡片。

原书依据 · 1 处
枚举顺序与修改要看契约

本书按ES5背景描述for/in顺序及枚举期间增删成员的实现差异,不能把这些历史描述概括为所有当前对象都毫无顺序规定。需要依赖结果次序时,应核对实际语言版本与对象条件,或显式建立所需顺序;也不应靠在枚举中新增属性来保证它一定被随后访问。

枚举顺序与修改要看契约保存独立卡片。

原书依据 · 1 处

5.6 跳转

跳转语句改变接下来的控制位置,但各自离开的范围不同:退出循环、进入下一轮、离开函数或传播异常,不能只按“提前结束”把它们混用。标签又受词法包围和函数边界约束。

5.6.1 标签语句

标签为一条包围语句命名,break或continue在允许范围内引用它。标签有自己的命名空间,却不是任意地方都能跳转的地址,更不能越过函数边界。

语句标签不是任意跳转地址

标签为所标识语句及其内部允许的控制跳转提供目标,名称与普通变量名分属不同空间。它不能在程序任意位置被当作goto地址,也不能与内部活动标签冲突。break可用于退出相应包围语句,continue还要求目标是可继续的循环;标签名相同不表示两种跳转能力相同。

语句标签不是任意跳转地址保存独立卡片。

原书依据 · 1 处

5.6.2 break语句

无标签break离开最近循环或switch,带标签则离开对应包围语句。二维求和例使用一个外层标签汇合多层失败出口,success只在完整遍历后置真;提前退出不等于结果已成功完成。

break退出范围由目标决定

无标签break退出最近的循环或switch,带标签break可离开对应的包围标签语句,包括循环或语句块,不能跨越函数调用边界。标签与break之间也不能随意换行。应先确定要结束哪一层,再选择是否用标签;原书“不应该是循环”的句子应理解为“不必限于循环”。

break退出范围由目标决定保存独立卡片。

原书依据 · 1 处
多层提前退出要保留完成状态

矩阵求和例在遇到缺行或不接受的单元时用同一标签跳到汇合点,只有全部遍历后才把success置真。这样可以区分得到部分和与成功完成全部求和。判断不能只看sum已有数值;全局isNaN还会转换输入,代码本身也未证明所有单元都是真正数值或保证+=不会连接文本。

多层提前退出要保留完成状态保存独立卡片。

原书依据 · 1 处

5.6.3 continue语句

continue结束当前轮后,根据循环形式进入不同继续位置;for先执行更新再测试,while则回到测试。带标签continue仍必须指向包围循环,不能给任意块标签使用。

默认值或会覆盖合法假值关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处
继续循环仍需执行更新

continue跳过当前轮余下动作,但不会等同退出循环。for会先到更新表达式再测试,while回到条件,do/while到尾部测试,for/in则准备下一个名字。忽略这些位置会使把for简单搬成while后的计数行为不同。带标签形式仍需合法包围循环,并遵守标签同行要求。

继续循环仍需执行更新保存独立卡片。

原书依据 · 1 处

5.6.4 return语句

return为本次函数调用提供结果并发起离开函数的控制转移,不必写在文本最后。未带表达式时提供undefined;但离开途中若经过finally,还需遵守下一节的清理与完成规则。

分支条件要对应允许的值域关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处
return结果与离开函数配对

return可带表达式提供本次调用结果,也可不带表达式而提供undefined;到达它后不会继续执行普通后续语句。它可以用于提前结束,不要求必须写在函数文本最后。返回表达式不能另起一行;若路径还经过finally,原返回也可能被清理中的新跳转覆盖。

return结果与离开函数配对保存独立卡片。

原书依据 · 3 处

5.6.5 throw语句

throw通过异常完成打断当前路径,异常值可以承载诊断信息;处理沿活动的执行/调用路径寻找,而非由函数定义时的词法闭包决定。阶乘只拒绝负数,还不能证明所有输入合法。

递归计算要有终止路径关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处
异常值携带失败诊断

throw可抛出不同类型的值,Error对象提供name与message等诊断信息,便于处理者辨认失败。抛异常与正常返回是不同完成路径,不应把数字错误码或字符串异常当成普通成功结果。throw需要表达式,换行限制也不能按可无表达式的return理解。

Error.name通常来自相应原型,message可由构造参数建立;它们可被改写,不能只凭name字符串证明对象身份。Error()与new Error()都能创建实例。旧参考称Error.toString无规定不准确:标准按name和message组合文本,空值时省略相应部分。

异常值携带失败诊断保存独立卡片。

原书依据 · 10 处
异常沿活动调用路径传播

当前执行抛出异常后,会沿活动的包围处理结构及调用栈寻找可处理它的catch;若本函数没有处理,则可传播给调用者。函数在某个try内被定义,不等于以后任何地方调用它都自动受那条catch保护。异常传播路径与词法名字解析链是两种机制,不能混为一条链。

异常沿活动调用路径传播保存独立卡片。

原书依据 · 1 处

5.6.6 try/catch/finally语句

try界定受保护路径,catch处理到达这里的异常,finally在控制权离开前执行清理。原来的正常、返回或异常是待完成结果;finally若发起新的异常或跳转,会覆盖它,不能误说成忽略finally的新动作。catch绑定又有自身局部范围。

捕获异常与清理承担不同职责

try后至少需要catch或finally之一。catch只在相关异常到达时执行处理,可恢复或重抛;finally在控制权离开受保护部分时处理清理,不代表错误已被恢复。只写try/finally可以做清理并让异常继续传播,不能因为有finally就宣称失败已经处理。

捕获异常与清理承担不同职责保存独立卡片。

原书依据 · 1 处
catch参数有独立局部范围

catch中的参数名接收本次抛出的值,并在该处理块的局部环境中可用,不与所有var绑定采用同一范围规则。被捕获的值也未必是Error对象,处理代码应按自己的契约理解。这是本书自己给出的局部范围例外,不能一边使用它,一边笼统宣称语言毫无块范围绑定。

catch参数有独立局部范围保存独立卡片。

原书依据 · 1 处
清理可覆盖原完成结果

离开try/catch时,原来的返回、异常或正常结果等待finally清理;若finally正常结束,再继续原完成路径。若它自己返回或抛错,新完成结果会覆盖旧结果,因此清理中的返回可能吞掉原异常。这里讨论控制权真正离开时的语言行为,不是任意中断下必定完成清理的保证。

结构图:

flowchart TD
 A[执行try] -->|异常| B[处理catch或保留异常]
 A -->|正常或跳转| C[保存待完成结果]
 B --> C
 C --> D[执行finally]
 D --> E{finally正常结束}
 E -->|是| F[继续原完成结果]
 E -->|否| G[采用finally的新结果]

清理可覆盖原完成结果保存独立卡片。

原书依据 · 2 处
循环改写要核对全部出口

把for的更新移到while体末尾,continue可能跳过更新;再一律放进finally,又会在break等离开路径上多做本来不该做的更新。判断改写是否等价要比较正常、continue、break、return和异常等出口,不能只看无跳转时输出相同。这说明本节简化改写不足,不表示while在表达能力上绝不能模拟for。

循环改写要核对全部出口保存独立卡片。

原书依据 · 2 处

5.7 其他语句类型

剩余小节将讨论with环境查找、调试暂停点和严格模式指令,分别改变名称解析、调试观察或语义约束。这里原文的width应为with,按实际标题与代码理解。

5.7.1 with语句

with把对象成员放进一段代码的名字解析前端,使同一个赋值名可能指向对象属性或外层绑定。它并非自动给对象创建所有出现的名字,严格模式禁止这种结构;用明确对象前缀可显露责任。

with会改变名字解析目标

本书非严格语境中,with(o)内的名字优先尝试从对象环境解析;若o有x,x=1可写该属性,否则可能写到外层绑定或产生隐式全局属性,不会自动创建o.x。它减少前缀却隐藏了目标身份,也增加分析难度。严格模式禁止with,短变量保存对象再显式访问属性更容易看清写入对象。

with会改变名字解析目标保存独立卡片。

原书依据 · 1 处

5.7.2 debugger语句

debugger在可配合的调试环境中提供暂停点,帮助观察变量与活动调用栈。它本身不替程序处理异常,也不保证没有调试器时自动启动工具或暂停。

调试断点依赖调试环境

debugger语句可在支持且启用相应调试环境时请求暂停,便于观察局部值和调用栈;没有这种配合时不能假定它自动启动调试器。用条件限制暂停,可围绕特定异常输入定位来源。这是诊断动作,不等于异常已恢复或输入已验证;Firebug等旧工具只属本书历史例子。

调试断点依赖调试环境保存独立卡片。

原书依据 · 1 处

5.7.3 “use strict”

严格模式既限制部分语法,也改变某些运行行为,不只是任意旧代码的文本子集。指令位置、名字绑定、接收者转换及arguments映射需要分别判断;原书“严格不能给任何全局属性赋值”“参数静态副本”及重复属性的历史限制都必须限定。

严格指令需处于开头序列

本书用带引号的”use strict”在脚本或函数体开头的指令序列启用严格语义,它不必是文件第一行,但不能放在普通语句之后仍期待生效。函数可继承定义位置的严格环境;直接和间接eval还应按各自规则判断。原书拼成”scrict code”的文本不是同一指令,也不把未来use关键字的预测当现行语法。

严格指令需处于开头序列保存独立卡片。

原书依据 · 1 处
严格赋值区分绑定与属性

严格模式下,向解析不到的标识符赋值会报错,不能靠拼错名字隐式创建全局绑定;但这不等于禁止给可扩展的全局对象显式设置合法新属性,也不禁止修改已声明的可写参数。名字解析、属性访问与可写性是不同检查,不能把原书那条长列表理解为所有这些赋值一律ReferenceError。

严格赋值区分绑定与属性保存独立卡片。

原书依据 · 1 处
严格写入失败会显式报告

严格模式会使某些本来静默失败的写入显式抛TypeError,例如只读属性、只有getter的属性或不可扩展对象上的新属性。它有助于暴露状态未被更新的事实,但不会把非法动作自动修复。语法错误、名字解析错误和写入限制也不是同一种错误类别。

严格写入失败会显式报告保存独立卡片。

原书依据 · 2 处
函数模式影响接收者转换

对本书普通严格函数,直接普通调用可使this为undefined,call/apply显式提供的原始值或null也不会按非严格规则自动装箱或替为全局对象。决定这种转换的是被调用函数自身的模式及调用约定,不是简单看调用位置是否严格;也不能把所有非严格this都概括成永远全局对象。

函数模式影响接收者转换保存独立卡片。

原书依据 · 2 处
参数与索引可取消赋值联动

本书严格函数的arguments索引不再与同名形式参数保持赋值联动,一边重新赋值不会自动改掉另一边的绑定。它并非把对象参数深复制或冻结:两处若仍保存同一个对象引用,内部属性变化仍可能共享可见。“静态副本”因此应理解为取消绑定映射,而非不可变数据快照。

参数与索引可取消赋值联动保存独立卡片。

原书依据 · 3 处
严格语法限制带有版本边界

本书ES5严格语法限制包括重复参数、遗留前导零八进制及某些eval/arguments绑定用途;它还记录了当时对重复对象属性的限制。不同事项并不具有相同的长期状态:重复属性限制已在ES2015移除,不能凭旧表判断当前全部代码。应按具体记号与目标版本逐项核对,而非只贴“严格”标签。

严格语法限制带有版本边界保存独立卡片。

原书依据 · 1 处
调用栈自省接口受到限制

本书严格模式限制通过arguments.callee及某些caller/arguments反射入口取得函数或调用者信息。这些接口可能暴露跨调用边界的数据,也让实现优化更难;具体可用性依版本与接口而定。函数需要递归或传递上下文时,不应把能任意观察上层调用栈当成默认语言契约。

调用栈自省接口受到限制保存独立卡片。

原书依据 · 2 处

5.8 JavaScript语句小结

语句表汇总各结构的语法与用途,表00014与00015已完整查看。脚注补充case表达式、for/while改写、ES3枚举空值差异,以及finally返回覆盖异常;这些属于前面机制的限定,不是另起一套运行结果。

清理可覆盖原完成结果关联本项背景,实质主要讲解在对应位置。

循环改写要核对全部出口关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

第6章 对象

对象把属性、原型和对象级特征结合起来。属性可写、可枚举、可配置描述的是各自权限,不能从“动态对象”推断任意写入总能成功;对象来源分类也不应混淆原生与内置。

属性权限与对象特征分层

属性的值及其可写、可枚举、可配置特征,与对象自身的原型、可扩展性处于不同层次。数据属性和存取器属性还具有不同的描述项,不能把所有属性都当普通可写值。本书的class是ES5内部分类标记,不是现代class声明或名义类型证明。判断一次修改是否合法,要看具体对象和属性的限制。

属性权限与对象特征分层保存独立卡片。

原书依据 · 1 处

对象来源分类不是同义词

原书以语言提供、宿主提供、用户创建介绍对象来源,但native与built-in不能简单互译为同一个集合。ES5.1术语中,原生对象的语义由语言规范界定;内置对象是程序开始时实现已提供的其中一类。程序运行中创建的普通对象也可属于原生对象。判断能力还要看具体接口,不能仅凭“用户对象”标签推断。

对象来源分类不是同义词保存独立卡片。

原书依据 · 1 处

6.1 创建对象

本节列出字面量、构造调用与Object.create三个创建入口;它们接下来分别说明,不能把这些写法当作必然具有相同原型和属性描述。

6.1.1 对象直接量

对象字面量以属性名和值表达式创建一个新对象,空字面量只表示没有自有属性。键的语法与版本、每次求值新身份与值表达式的求值需要分开理解。

对象字面量每次创建新身份

对象字面量每次被求值都会创建新对象,属性值表达式在该次求值中计算;外观相同不表示对象身份相同。空字面量{}表示没有列出的自有属性,通常仍会继承Object.prototype。键可写作标识符或字符串;本书区分ES3与ES5对保留字键的历史限制,旧浏览器对末尾逗号的兼容问题也应放回当时背景。

对象字面量每次创建新身份保存独立卡片。

原书依据 · 1 处

6.1.2 通过new创建对象

new后接构造调用可创建并初始化对象,示例分别使用Object、Array、Date、RegExp。原文把它们概括成所有原始类型均有构造函数并不准确,null与undefined不具有这种包装构造入口。

构造函数初始化实例关联本项背景,实质主要讲解在对应位置。

转换函数与包装构造分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 11 处

6.1.3 原型

普通对象通过内部原型引用形成共享查找链,链末端可以是null。构造函数的prototype属性与实例的内部原型引用属于不同位置,不要把所有对象都误说成一定另有一个对象原型。

原型引用与构造属性分开

对象的内部原型引用可指向另一个对象或null;null本身不是对象。普通字面量通常继承Object.prototype,后者的原型为null;同一环境中数组实例通常沿Array.prototype再到Object.prototype。构造函数自身的prototype是可供构造过程使用的属性,不等于该函数对象自己的内部原型,也不等于每个实例都拥有一个同名自有属性。

原型引用与构造属性分开保存独立卡片。

原书依据 · 6 处

6.1.4 Object.create()

Object.create直接指定新对象原型,可选的第二参数描述自有属性。原书inherit函数只提供非null原型的简化兼容策略,继承包装也只是某些写入路径的隔离,不能当全面安全边界。

创建对象时可直接指定原型

Object.create以给定对象或null作为新对象原型,并可接收属性描述信息。以null为原型的新对象不继承Object.prototype的方法,但仍可后来添加自己的属性和方法。它与{}并不完全等价,依赖继承方法的代码应先核对接收对象是否提供那些方法。

创建对象时可直接指定原型保存独立卡片。

原书依据 · 2 处
简化继承函数不等于完整实现

本书inherit(p)先拒绝null,支持时调用Object.create,否则借助临时构造函数的prototype创建对象。这个兼容策略只覆盖指定非null原型的核心用途,没有实现Object.create的全部参数与行为。阅读这种垫片时应先列清它实际承诺的输入与输出,不能因函数效果相近就把两者完全互换。

简化继承函数不等于完整实现保存独立卡片。

原书依据 · 1 处
继承包装不构成全面隔离

把对象作为原型再传给库,可让部分普通数据属性赋值在派生对象上形成遮蔽,但不能据此承诺原对象绝不变化。共享的嵌套对象仍可能被修改,继承的setter可以执行其他写入,代码也可能主动操作原型。该技巧适用于已知写入方式的便利包装,不是对不可信代码的安全沙箱。

继承包装不构成全面隔离保存独立卡片。

原书依据 · 1 处

6.2 属性的查询和设置

点访问用于代码中直接写出的名字,方括号访问接受运行时计算的键。读取和写入共用访问语法,但结果还依赖属性定义与对象状态。

固定属性名与计算属性键分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

6.2.1 作为关联数组的对象

对象可用运行时字符串键组织关联数据,股票例子说明动态名字为何需要方括号。动态能力与弱类型不是一回事,属性权限、原型以及枚举范围仍会限制可用行为。

动态字典需明确成员边界

股票持仓例子用股票名作属性键、份额作值,因此可在运行时用方括号读写。汇总时仍需明确哪些成员算业务数据:for/in可能遍历继承的可枚举属性,不能不加判断地把每个名字都当持仓;对外部键名也要考虑与原型成员的冲突。这个例子解释数据组织方式,并未给出可直接用于真实投资估值的完整实现。

动态字典需明确成员边界保存独立卡片。

原书依据 · 2 处

6.2.2 继承

查询先看自身,再沿原型链查找直到null。普通可写数据属性的赋值通常形成或更新接收对象的自有属性,但继承只读限制和存取器setter会改变结果,因此继承仍参与写入判定。

属性查询走原型链但赋值只作用于自身

普通对象读取属性时先检查自有属性,再沿原型链向上查找,未找到时得到undefined。赋值不能笼统说成“永远只作用于自身”:普通可写数据属性的赋值通常更新或创建接收对象的自有属性,从而遮蔽继承值;继承的只读属性可能阻止赋值,继承的setter则会接收这次设置。setter中的this通常是接收对象,但它的函数体仍能修改共享对象或其他状态,不能由此保证原型绝不受影响。共享原型也不等于共享值可安全任意修改。

属性查询走原型链但赋值只作用于自身保存独立卡片。

原书依据 · 1 处

6.2.3 属性访问错误

属性未找到、对空值继续取属性,以及对象拒绝写入是三种不同情况。短路防护需确认所检查的条件;可写性、继承的setter和对象可扩展性共同影响设置结果。

严格写入失败会显式报告关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处
未找到属性不等于空值可访问

对有效对象查询不存在的属性通常返回undefined;如果接着对这个undefined访问length,就会抛类型错误。null和undefined本身不能继续访问属性。通过&&逐级防护可避免部分空值访问,但短路表达式返回的是遇到的操作数,不保证结果总为undefined,也不能把合法的0或空字符串与缺失混成一种情况。

未找到属性不等于空值可访问保存独立卡片。

原书依据 · 1 处

6.3 删除属性

delete解除的是对象上的自有属性关联,不会递归清理属性所指对象。可配置性决定能否删除;继承属性不被从接收者删除,返回true也不说明该名字之后一定查不到。

删除属性不同于清空属性值关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

删除自有属性可能显露继承值

delete针对接收对象上的自有属性;删除成功后,后续查询仍可能找到原型链上的同名属性。对继承属性执行delete通常没有删除其定义,仍可返回true。因此应把“本次删除是否被允许”“自有属性是否存在”与“查找能否找到同名值”分开,不能用一个成功返回推断三个问题都已解决。

删除自有属性可能显露继承值保存独立卡片。

原书依据 · 1 处

6.4 检测属性

检测属性要先确定关心继承链、自有成员、可枚举性还是具体值。值为undefined仍可具有真实属性,hasOwnProperty同样可以区分自有属性的存在,不能说只有in能检测这种差别。

三种属性存在性检测各自的语义边界

判断属性是否存在前先明确范围:in检查对象及其原型链上是否有该名字;hasOwnProperty检查是否为自有属性;propertyIsEnumerable进一步要求它是自有且可枚举的属性。读取后与undefined比较检查的是结果值,不能区分未找到和已有属性恰好取值undefined。in并非唯一能区分缺失与undefined的方法,hasOwnProperty也能在自有属性范围内做到。方法可能缺失或被同名属性遮蔽,直接调用前也应考虑对象来源;真假值测试还会忽略合法的0、false和空字符串。

三种属性存在性检测各自的语义边界保存独立卡片。

原书依据 · 3 处

6.5 枚举属性

枚举需要明确自有与继承、可枚举与全部名字两个维度;工具函数展示复制、合并与筛选,但源码错误和浅复制限制不能忽略。

枚举接口覆盖不同成员集合

本书ES5中,for/in遍历可枚举的字符串键,包含继承成员;Object.keys返回可枚举自有字符串键;Object.getOwnPropertyNames还包括不可枚举的自有字符串键。三个集合不能随意互换,现代Symbol键还不在后两个接口结果内。按值是否为函数过滤只是在筛选值的形态,不等于过滤继承成员。

枚举接口覆盖不同成员集合保存独立卡片。

原书依据 · 3 处

复制属性值不等于复制对象

例6-2用for/in读取源成员并赋值给目标,因而可能包含继承的可枚举属性,触发getter,且嵌套对象仍共享引用。它没有保留属性描述或存取器本身。名字冲突、目标写入限制及原型成员都需要另作约定,不能把extend、union等简短函数当成深复制或完全隔离工具。

复制属性值不等于复制对象保存独立卡片。

原书依据 · 1 处

合并示例先纠正成员检查

例6-2的merge意图保留目标已有自有属性,但印刷代码写成o.hasOwnProperty[prop],它是在读取函数对象上的属性,不是在调用成员检测。应按意图使用方法调用,并考虑该方法被遮蔽的情况;循环变量也应明确声明。理解注释后仍须核对实际表达式,不能因函数名为merge就断言它已实现所述合并策略。

合并示例先纠正成员检查保存独立卡片。

原书依据 · 1 处

6.6 属性getter和setter

存取器将读取和设置委派给函数,使同一数据有多个访问视图,也可在读写中执行校验或改变状态。调用接口保持属性语法,却不能保证读取纯净、廉价、稳定或隐藏实现。

存取器属性把属性访问伪装成方法调用

存取器属性用getter或setter承接属性访问:读取时调用无参数getter,设置时把右侧值传给setter,setter返回值不替代赋值表达式的值。只提供getter的属性不能按普通赋值设置;只提供setter时读取通常得到undefined。坐标例子的r同时可读写,theta只有getter。存取器可继承,并通常以接收对象作为this;它可以计算、校验或产生副作用。调用语法虽与普通属性相同,描述符仍可暴露两者区别,不能说调用者永远无法辨别。

存取器属性把属性访问伪装成方法调用保存独立卡片。

原书依据 · 1 处

派生坐标写入需处理退化输入

坐标例子通过x和y计算半径,再按新旧半径比例缩放两个分量,使读写两种表示关联起来。该写法需要旧半径非零等输入前提;原点会导致比例计算退化,目标半径的含义也需定义。它解释存取器如何维护派生视图,并不是未经验证即可用于全部几何输入的完整实现。

派生坐标写入需处理退化输入保存独立卡片。

原书依据 · 1 处

有状态读取不是稳定快照

序列号getter每次读取后递增,随机数getter每次重新取样,因此同一个属性表达式可以产生不同值并改变状态。$n只是命名暗示,外部仍能直接修改,不能提供真正私有或不可绕过的单调保证。基于Number的计数还受精确整数范围限制,这类演示不能直接充当持久唯一编号系统。

有状态读取不是稳定快照保存独立卡片。

原书依据 · 1 处

6.7 属性的特性

属性描述符把值或访问器及其权限显式表达出来。查询只面向自有属性;定义新属性与修改旧属性的缺省规则不同,不可配置也不是所有变化一律禁止。

描述符分为数据与存取器两类

数据描述符用value、writable、enumerable、configurable描述属性;存取器描述符用get、set替换前两项。get和set可为函数或undefined,不能把两组互斥描述项混在一个定义里。Object.getOwnPropertyDescriptor查询的是指定自有属性;没有自有定义时返回undefined,不代表原型链上也没有该名字。

描述符分为数据与存取器两类保存独立卡片。

原书依据 · 2 处

定义属性缺省取决于是否已存在

Object.defineProperty新建属性时,省略的布尔权限通常为false,值或访问器为undefined;修改已有自有属性时,未提供的描述项通常保持原状。因此只写value的新定义不等于普通赋值创建的默认可写、可枚举、可配置属性。defineProperties接收多份描述,不能仅凭多属性接口就假定失败时具有事务回滚能力。

定义属性缺省取决于是否已存在保存独立卡片。

原书依据 · 4 处

不可配置仍可能收紧可写权限

不可配置属性不能改回可配置,不能改变可枚举性,也不能在数据与存取器种类之间切换。不可配置数据属性若仍可写,可以更新值并把可写性收紧为false;一旦又不可写,就不能再改成true或换成不同的值。存取器不可配置时也不能换成其他getter或setter。可配置但不可写属性则仍可能通过合法的定义操作改值,区别于普通赋值。

不可配置仍可能收紧可写权限保存独立卡片。

原书依据 · 2 处

保留描述符复制仍需确定冲突策略

例6-3枚举源对象全部自有字符串名字,再取得描述符并在目标上定义,可保留不可枚举性和存取器函数,而不只是读取一次值。它用in判断冲突,所以目标继承的同名属性也会阻止复制;共享对象值与访问器闭包仍可能共享状态。示例还修改Object.prototype,应先评估全局影响,不能把不可枚举等同于没有兼容风险。

保留描述符复制仍需确定冲突策略保存独立卡片。

原书依据 · 1 处

getter和setter的老式API

旧访问器接口以双下划线命名,用来查询或定义getter与setter。本书说它们非标准反映当时背景;后来的规范已纳入遗留兼容部分,也不能推断无原型对象一定具有这些方法。

遗留访问器接口需标出版次

本书介绍lookupGetter、lookupSetter以及defineGetter、defineSetter作为当时实现中的旧接口。后来的ECMAScript规范已把它们列为遗留且规范可选的兼容功能,不能把“永远非标准”当长期事实。它们通常来自Object.prototype,并非所有对象都保证继承。维护旧代码要核对环境,新的属性描述需求可用明确的描述符接口表达。

遗留访问器接口需标出版次保存独立卡片。

原书依据 · 2 处

6.8 对象的三个属性

这里把对象级原型、内部类标签和可扩展性汇集到一起;它们分别关联继承、类型显示和新增属性权限,后面三节分别展开。

6.8.1 原型属性

查询内部原型应使用对应接口;constructor是可继承和可修改的普通属性,不能可靠反推出原型。isPrototypeOf检查链上成员关系,而原书浏览器支持表只代表历史。

构造属性不能可靠反推原型

Object.getPrototypeOf查询对象实际的内部原型;o.constructor.prototype只是先读取一个名为constructor的属性,再读取其prototype,二者不保证相同。constructor可能被遮蔽、改写或根本不存在,Object.create指定的原型也不必与那个构造属性匹配。诊断继承结构时应直接问原型关系,不能把普通约定当语言保证。

构造属性不能可靠反推原型保存独立卡片。

原书依据 · 5 处
原型链成员检测不检查自身

p.isPrototypeOf(o)检查p是否出现在o的原型链上,因而可同时识别直接与更上层原型;它不把o自身算作链上的原型。该问题不同于两个对象是否身份相同,也不同于某构造函数是否真的曾创建过o。接收者还要确实提供可用方法,不能默认所有对象都继承这一入口。

原型链成员检测不检查自身保存独立卡片。

原书依据 · 3 处

6.8.2 类属性

借用Object.prototype.toString可绕开目标自有toString的普通重写,得到对象标签。本书ES5中它比typeof更细,但无法识别任意自定义类,现代Symbol.toStringTag还可影响输出。

借用Object原型的toString判断真实类型

在本书ES5语境中,Object.prototype.toString.call(o)把指定基础方法应用于o,避免直接调用o.toString时选中另一个实现,并可获得Array、Date等较细标签。它并非不可伪造的“真实类型”证明:自定义构造实例通常仍标为Object,宿主结果依环境,现代Symbol.toStringTag还能改变显示标签。该技巧说明方法选择与接收者绑定可以分开,但并非任意内置方法都能无条件借给任意对象。

借用Object原型的toString判断真实类型保存独立卡片。

原书依据 · 2 处

6.8.3 可扩展性

preventExtensions、seal与freeze逐级收紧新增和自有属性权限,但不会递归冻结共享对象,也不会消除存取器或继承带来的可变状态。

不可扩展只限制新增自有属性

Object.preventExtensions阻止新增自有属性,并且普通对象不能再恢复为可扩展;它不自动删除已有属性,也不使已有可写属性变为只读。原型对象若后来增加属性,接收者仍可能继承到,因此不可扩展不代表整个可观察成员集合永远不变。Object.isExtensible用于查询这一状态,原书接口拼写错误不应照抄。

不可扩展只限制新增自有属性保存独立卡片。

原书依据 · 3 处
封闭与冻结约束不同写入

Object.seal使对象不可扩展,并把自有属性设为不可配置;其中已有可写数据属性仍可更新。Object.freeze再把自有数据属性设为不可写,但通常不递归冻结属性值指向的对象,已有setter仍可被调用并执行其逻辑。三种锁定接口返回原对象而不是隔离副本,不能因此承诺深层数据不可变或完全无副作用。

isFrozen检查不可扩展、全部自有属性不可配置且自有数据属性不可写,条件是同时满足。仅封闭可写对象并不冻结,仅各现有属性只读却仍可扩展也不冻结;空且不可扩展对象可自然满足。参考isFrozen条目的“或者”和“可以添加”均不准确。

封闭与冻结约束不同写入保存独立卡片。

原书依据 · 5 处

6.9 序列化对象

JSON表示的是受限的数据形态,序列化再解析只能在这种形态范围内重建值。原文把无穷大列为JSON数字,以及把函数、正则、错误笼统说成完全不能序列化,都需要按实际行为限定。

JSON往返不是通用深复制

示例普通对象的JSON往返可重建嵌套数据,却不会完整保留任意对象的原型、属性描述符、函数、对象身份共享或Date类型。循环引用通常还会使stringify失败。它适合约定的数据交换形态,不能只凭示例注释就替代通用对象复制策略;使用前应先约定哪些值和关系允许被丢失或转换。

JSON往返不是通用深复制保存独立卡片。

原书依据 · 2 处

JSON省略与空值替换依位置

JSON数字不包含NaN或正负Infinity;stringify遇到这些数值会用null表示。对象中值为undefined或函数的成员通常被省略,而数组中的此类位置通常变成null,顶层又可能根本不产生字符串。RegExp或Error实例的普通可枚举自有数据仍可能被序列化,只是其内置语义通常不能完整还原;不能说任何这类对象都完全不能进入JSON处理。

JSON省略与空值替换依位置保存独立卡片。

原书依据 · 3 处

日期序列化后仍需恢复类型

Date通常通过toJSON形成日期字符串,而JSON.parse不会自动把这样的字符串恢复成Date对象。stringify的第二参数可用替换函数或属性列表,parse的第二参数则是恢复转换函数,不是同一种列表接口。数据协议应明确类型恢复与校验责任,不能因字符串看起来像日期就假设它已具备日期对象能力。

Date.toJSON忽略key参数;通常把有效日期交给toISOString,无效Date数值为NaN时返回null。该方法按规范有意通用,不要求Date内部槽,但后续需要可调用的toISOString等契约;原书“不是通用方法”不准确。

日期序列化后仍需恢复类型保存独立卡片。

原书依据 · 3 处

6.10 对象方法

本段把前面已讲的成员检测与Object静态函数连接到对象转换方法;Object.prototype方法可被重写,也可能因原型链不同而根本不被继承。

6.10.1 toString()方法

toString可提供字符串表示,但默认输出信息有限,自定义和内置对象可能重写它。对象参与转换时也不保证总是先调用这个方法,仍需按原始值转换规则判断。

转换提示决定方法尝试顺序关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

6.10.2 toLocaleString()方法

本地化转换是一组可重写的约定;Object默认实现只是委派toString,Date和Number可给出面向地区的结果,数组会逐元素使用本地化表示。

本地化字符串不等于稳定编码

默认Object.prototype.toLocaleString只是调用接收对象的toString,并不自己增加地区格式。Date、Number与数组等可提供不同的本地化行为;显示结果依对象和环境,不适合未经约定就当作稳定交换编码或可逆输入格式。需要地区友好展示与需要机器可重复解析,是两个不同用途。

本地化字符串不等于稳定编码保存独立卡片。

原书依据 · 4 处

6.10.3 toJSON()方法

toJSON不是Object.prototype的默认方法,但JSON.stringify在适用时会调用对象提供的该方法,用返回值继续组织JSON输出。方法返回值本身不一定已经是最终编码文本。

序列化钩子返回的是替代值

对象提供toJSON时,JSON.stringify会在相应处理过程中调用它,并继续序列化返回的替代值。它并非要求方法自行返回最终JSON文本;若返回一个普通字符串,那个字符串仍按JSON字符串规则编码。Date借此提供日期字符串表示,Object.prototype本身却不默认定义这个方法,因此它是可选钩子而不是所有对象都有的能力。

序列化钩子返回的是替代值保存独立卡片。

原书依据 · 3 处

6.10.4 valueOf()方法

valueOf参与对象到原始值的转换,但选择和顺序由具体提示及方法结果决定。脚注还包含类型分类、删除、字面量调用等补充,其中几条不能按绝对陈述使用。

转换提示决定方法尝试顺序关联本项背景,实质主要讲解在对应位置。

删除属性不同于清空属性值关联本项背景,实质主要讲解在对应位置。

原书依据 · 7 处

第7章 数组

数组是带有索引和特殊length约束的对象,可混合保存不同类型值,也可留下空槽。它的语言上限、实际已有成员数与引擎存储容量不是同一个问题。

数组长度上限不是已存数量

数组索引范围为0到2^32−2,length最大可为2^32−1;length描述索引范围边界,不保证范围内每一项都已有自有元素。数组可保存不同类型的值,也可形成嵌套结构。这些语言界限不代表实际机器一定能存放同样数量的值,性能和内存开销也不能只凭数组类型作统一保证。

数组长度上限不是已存数量保存独立卡片。

原书依据 · 3 处

7.1 创建数组

字面量创建与Array构造器有不同参数语义:一个数值参数表示长度,多个参数或单个非数值参数表示成员。字面量省略项形成空槽,不是自动定义undefined元素。

空槽不同于存入未定义值关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

数组构造器的单数值表示长度

Array构造器接收单个数值时按长度处理,并不把该数放在索引0;多个实参或单个非数值实参则用作成员值。因此new Array(10)与[10]结构不同,前者也没有自动创建十个值为undefined的自有索引属性。选择写法时要先明确要表达长度还是一个数据元素,不能把构造器调用当作字面量的纯语法替换。

数组构造器的单数值表示长度保存独立卡片。

原书依据 · 2 处

7.2 数组元素的读和写

方括号访问仍是对象属性访问,只有合格数组索引才与length发生特殊关联。负数、小数及不规范的数字字符串可能只是普通属性;数组属性也会受到继承、访问器和权限影响。

数字样式的键未必是数组索引

数组索引是特定范围内的规范整数属性名,写入超出现有长度的有效索引通常会把length更新为索引加一。负数、小数和超出索引范围的名字只是普通属性;数字值1.000转换后与1相同,但字符串”01”不会因此自动成为索引1。最大索引是2^32−2,不能把本节一处“小于2^32”的表述直接用作完整边界。

数字样式的键未必是数组索引保存独立卡片。

原书依据 · 1 处

数组读取仍可能触发对象行为

读取数组不存在的索引通常得到undefined,而不是固定产生越界异常;但原型链若提供同名成员,仍可能读到继承值或触发访问器。写入也需服从可写性、可扩展性与length权限。因此“数组没有越界错误”不等于所有数组读写都不会报错,更不意味着空槽永远读不到任何值。

数组读取仍可能触发对象行为保存独立卡片。

原书依据 · 1 处

7.3 稀疏数组

稀疏数组中的空槽是缺少对应自有索引属性,不能与已存undefined混同。原文在[,,,]的解释前后矛盾;按ES5.1初始化规则,省略项不会定义索引属性。

空槽不同于存入未定义值关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

7.4 数组长度

length增长可扩大索引范围但不会填值,缩短则尝试删除范围外自有元素。元素不可配置或length不可写会影响结果,缩短失败还可能已经删除部分较高索引。

缩短数组会尝试删除尾部成员

把数组length设为较小合法长度,会尝试删除索引不小于新长度的自有元素;增大length则只扩大范围,不自动填充undefined值。若较高索引不可配置,截短会受阻,不能保证所有修改被回滚;保留下来的不可删除索引仍要求length至少比它大一。length只读也会阻止某些增长或截短操作,因此这种赋值不是无条件的清空工具。

缩短数组会尝试删除尾部成员保存独立卡片。

原书依据 · 2 处

7.5 数组元素的添加和删除

添加可用索引赋值或push,前端插入用unshift;删除可留下空槽,也可伴随长度变化与元素移动。先明确位置语义再选择操作。

删除位置与压缩数组是两件事

delete删除自有索引属性通常留下空槽,不调整length,也不把后续元素前移。pop从尾部移除并缩短长度,shift从首部移除并调整后续位置,splice可在指定区域替换、插入或删除。因此若业务要求列表连续,应选择满足位置契约的操作,而不是把删除一个键与移除一个序列位置视作相同动作。

删除位置与压缩数组是两件事保存独立卡片。

原书依据 · 1 处

7.6 数组遍历

遍历策略同时决定索引顺序、成员集合和过滤条件。缓存长度会固定一次边界,真假过滤会排除更多合法值,for/in则不是只遍历自有数字索引。

数组遍历先定义缺失与合法值

!a[i]会跳过全部假值,不仅是null、undefined和空槽,还包括0、false、空字符串与NaN。a[i]===undefined不能区分缺失与显式undefined;i in a检查整个原型链,若只认自有元素还需自有成员检测。过滤条件应来自数据契约,而不是把注释中的“空”直接替换成真假测试。

数组遍历先定义缺失与合法值保存独立卡片。

原书依据 · 1 处

缓存长度会固定遍历边界

把length读入局部变量可避免循环条件反复取长度,但也把该次循环上界固定下来;若循环体改变数组长度,就可能与每轮重新读取length的行为不同。它不是单纯没有语义代价的性能替换。是否值得采用,应先确认遍历是否允许变长,再结合具体环境测量。

缓存长度会固定遍历边界保存独立卡片。

原书依据 · 2 处

枚举过滤不能替代索引契约

for/in可能列出可枚举继承成员和普通命名属性。仅检查hasOwnProperty不能保证名字是有效数组索引;原书数值化再比较字符串的筛选也未完整约束最大索引边界。算法若依赖0到length−1的位置顺序,用显式索引循环更直接;空槽如何处理仍需单独约定,不能靠过滤器名字猜测。

枚举过滤不能替代索引契约保存独立卡片。

原书依据 · 1 处

7.7 多维数组

嵌套数组可表示二维表,但每行仍是独立数组引用,没有自动强制等长或连续内存布局。乘法表示例先创建每一行再逐格初始化。

二维表示需逐行建立数组

用数组的数组表示表格时,外层元素保存行数组,table[row][col]分两次取值。只给外层设置长度不会自动产生每行数组,示例因此逐行创建再初始化。各行可以有不同长度,也可能意外共享同一行引用;需要规则矩阵时应明确创建与维度约束,不能仅由嵌套访问语法推断。

二维表示需逐行建立数组保存独立卡片。

原书依据 · 1 处

7.8 数组方法

传统数组方法提供文本化、重排、复制片段以及增删成员等操作。后面按是否修改原数组、返回什么结果和是否展开嵌套数据来比较;方法定义在Array.prototype上,不是默认存在同名Array静态函数。

7.8.1 join()

join把位置范围中的值转换为字符串并用分隔符连接。结果适合展示或约定文本拼装,但丢失类型和嵌套边界,不能认为与split普遍互为可逆变换。

数组文本化会丢失结构边界

a.join(“,”)用指定分隔符连接元素表示,省略分隔符时使用逗号;十个空位置可形成九个分隔符。结果不保存元素原始类型,元素自身含分隔符或嵌套数组时也可能出现歧义,因此join与split只在有额外数据约定时近似互逆。原书两个空字符串分隔调用给出不同结果,其中带空格的输出需实际使用空格分隔符才相符。

数组toLocaleString调用成员的本地化表示后连接,用于展示;地区与实现会影响结果。null/undefined等位置按连接规则处理,不是所有成员都直接调用方法。现行方法可借给合适类数组,不符合原文“不是Array就一定TypeError”的概括。

数组文本化会丢失结构边界保存独立卡片。

原书依据 · 5 处

7.8.2 reverse()

reverse会在原数组上重排并返回同一个数组,随后join可把该结果文本化;这与创建反序副本不同。下一节sort也属于原地重排,但使用比较规则确定顺序。

原地重排会影响共享数组

reverse在原数组上颠倒顺序,并返回该数组;sort同样修改并返回原数组,只是按比较规则排序。若其他变量共享同一数组引用,它们也会观察到位置变化。链式调用如a.reverse().join()先发生重排,再产生字符串,并不会让重排自动变成对副本操作。需要保留原顺序时应先明确如何建立所需副本,复制的深浅也另有边界。

原地重排会影响共享数组保存独立卡片。

原书依据 · 4 处

7.8.3 sort()

sort默认按字符串形式比较,数字数组因此可能不按数值大小排列。比较函数应提供一致的负、零、正结果,大小写折叠只是某种比较策略,不等于完整地区排序。

原地重排会影响共享数组关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处
排序比较需表达一致先后

sort省略比较函数时按字符串形式的字典顺序比较,故33、4、1111、222不会自动按数值升序。对适合相减的普通数值,示例比较函数return a-b以负、零、正表示先后;它不适用于所有可能值而不作校验。比较规则需要自洽,返回0表示此规则下等价,不应等同于值身份完全相同。大小写折叠可实现特定不区分大小写策略,却不等于语言地区的完整排序规则。

sort把已有undefined成员排在其他已定义值之后,且不交给比较器;真正空槽又与显式undefined区分。默认字符串比较不自动按数值大小,比较器返回值应表达一致的先后关系。

排序比较需表达一致先后保存独立卡片。

原书依据 · 3 处

7.8.4 concat()

concat创建外层新数组,并对作为参数的数组做一层元素连接;嵌套数组不会递归展开。新外层也不表示内部对象已经被复制。

数组片段复制仍可共享内部值

concat连接原数组元素和参数,数组参数通常只展开一层;slice取指定范围,两者都返回新的外层数组而不修改原数组。内部对象或嵌套数组引用仍可能共享,因此外层新身份不代表深复制。选择concat是拼接片段,选择slice是截取片段,二者都不能自动承担消除共享状态的任务。

slice(start,end)的范围包含start而不含end;省略end取到末尾,负位置相对数组尾部计。例如原书a.slice(1,-1)取中间片段,而不是删除头尾。

数组片段复制仍可共享内部值保存独立卡片。

原书依据 · 4 处

7.8.5 slice()

slice使用开始包含、结束不包含的范围,缺省终点可取到末尾,负数位置从尾部计。它创建片段而不删除源数组成员。

数组片段复制仍可共享内部值关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

7.8.6 splice()

splice在原数组指定位置删除并插入,后续索引按需移动,返回的是被删除的片段。它与slice名字相近,但副作用、第二参数和返回含义不同。

局部编辑返回被删除的片段

splice(start,deleteCount,…items)在原数组编辑指定位置,deleteCount是删除数量,不是结束索引;后续实参按顺序插入,并返回删除成员组成的数组。原书a.splice(2,0,‘a’,‘b’)只插入而返回空数组;插入一个数组时保留它为单个成员,不像concat那样默认展开数组参数。省略第二参数可从给定起点删到结尾,不能误写成不删除。

核心参考的八成员例连续操作应为:splice(1,2)删[2,3]后原数组[1,4,5,6,7,8];再splice(1,1)删[4]后为[1,5,6,7,8];再splice(1,0,2,3)返回[],原数组[1,2,3,5,6,7,8]。原文注释把尾部误删,不能用其校验实现。

局部编辑返回被删除的片段保存独立卡片。

原书依据 · 2 处

7.8.7 push()和pop()

push和pop在尾部增删使数组具备后进先出操作,返回值却不同:push返回新长度,pop返回移出的值。结合下一节首部操作可选择不同的队列顺序。

两端操作构成栈与队列

push在尾部加入并返回新长度,pop从尾部移出并返回移出的值,组合得到后进先出的栈。shift从头部移出并返回值,unshift在头部加入并返回新长度;尾进头出的push与shift可表达先进先出顺序。它们都修改原数组,不能把返回长度当作新增元素或返回的新数组。一次unshift多个参数保持参数次序,逐次首插则会反转加入次序。

两端操作构成栈与队列保存独立卡片。

原书依据 · 6 处

7.8.8 unshift()和shift()

unshift一次把多个参数按给定次序放到前面,并移动既有位置;shift移出头项并前移其余成员。它们与尾部方法组合时要区分加入顺序和返回含义。

两端操作构成栈与队列关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

7.8.9 toString()和toLocaleString()

数组toString通常给出逗号连接表示,嵌套结构在输出中会变模糊;toLocaleString则逐元素使用本地化表示,结果仍不具有完整结构保真能力。

数组文本化会丢失结构边界关联本项背景,实质主要讲解在对应位置。

本地化字符串不等于稳定编码关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

7.9 ECMAScript 5中的数组方法

ES5数组遍历方法用回调表达每项操作、转换或判断,但调用参数、返回值处理和this规则并不完全相同。跳过空槽也只在相应位置没有可见属性时成立。

回调式遍历仍可产生副作用

forEach、map、filter等方法把当前值、索引和源数组传给回调,并依各自用途处理返回值。方法本身不以重排原数组为目标,不表示整个调用一定无副作用:回调可修改源数组,读取还可能调用getter。许多方法支持thisArg,但reduce的第二参数是初始累计值,不能把一套签名套给全部接口。

省略thisArg时普通严格回调的this是undefined,参考条目写成null不准确;显式传null则严格回调保留null。thisArg不覆盖箭头函数的词法this。

回调式遍历仍可产生副作用保存独立卡片。

原书依据 · 2 处

7.9.1 forEach()

forEach用于按索引遍历并执行动作,不收集回调返回值,也没有直接对应break的正常控制入口。原书用专用异常中断只是一种包装策略,需要继续传播其他异常。

逐项执行不提供普通提前成功返回

forEach为访问到的成员执行回调,适合累计外部结果或逐项动作;回调中的return不会像外层循环break那样结束整个遍历。原书包装函数用一个特定异常对象识别主动中止,并重新抛出其他错误,避免误吞故障。它并非只能等全部完成才退出:异常也会中断。需要常规短路判断时可用具有相应契约的some、every或显式循环。

逐项执行不提供普通提前成功返回保存独立卡片。

原书依据 · 2 处

7.9.2 map()

map把回调结果放入新数组的相应位置,返回结果需要由调用方使用。对本书普通稀疏数组,未访问位置继续保持空槽,不能把map当压缩工具。

映射保留位置而筛选压缩成员

map按原位置保存回调返回值,普通稀疏输入中的空槽通常保留下来;filter则根据判定是否为真把保留成员依序放入新数组,形成连续结果。前者表达每项变换,后者表达成员选择。都建立新外层数组,却不保证回调或内部对象无共享修改;若要得到变换结果,map回调必须实际返回所需值。

压缩空槽可用恒真判定;若只排除null与undefined,示例使用显式比较,不会因此删掉0、false或空字符串。判定返回值按真假解释,不要求返回值本身恰好是布尔类型。

核心参考filter条目把概要误写为array.map(predicate),应调用filter(predicate, thisArg);map用返回值构造对应位置结果,filter才按真假保留原成员。

映射保留位置而筛选压缩成员保存独立卡片。

原书依据 · 4 处

7.9.3 filter()

filter用回调结果的真假决定保留成员,可用恒真判定压缩普通稀疏数组空槽,也可显式排除null和undefined,而保留其他假值。

映射保留位置而筛选压缩成员关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

7.9.4 every()和some()

every与some对应全称和存在判断,分别在首个反例或首个满足项处短路。空集合上的结果来自量词含义,并不能拿every为真证明数据非空。

全称与存在有不同空集结果

every仅在访问到的成员全部满足判定时为真,遇到首个反例即可停止;some遇到首个满足项即为真,否则为假。空数组上every为真、some为假,反映全称与存在量词的区别。普通空槽不构成一个自动失败的成员;如果业务还要求至少一项,就要另行表达非空约束,而不是只依赖every的返回值。

全称与存在有不同空集结果保存独立卡片。

原书依据 · 3 处

7.9.5 reduce()和reduceRight()

reduce通过累计值把多项组合成一个结果,初始值决定空输入和首轮处理。方向在非交换组合中会改变结果;本节关于this参数和union冲突胜者的两处陈述与接口或此前代码不符。

折叠初始值决定空输入行为

reduce(callback,initialValue)把累计值与当前成员组合,再把回调返回值用于下一轮;累计结果不必是数字。提供初始值时可自然处理空输入,缺省时使用首个可访问成员作起点,没有任何可访问成员就会抛类型错误。回调参数是累计值、当前值、索引和源数组,第二个方法参数不是thisArg;需要固定回调接收者时应采用适用绑定方式。

折叠初始值决定空输入行为保存独立卡片。

原书依据 · 2 处
折叠方向影响非交换组合

reduce从低索引向高索引组合,reduceRight反向处理;对乘方或有冲突覆盖策略的对象合并,结果会因此不同。本书union的定义实际以第二个参数的同名值覆盖第一个,因此用它左折叠时最后一个对象的a值胜出,右折叠时第一个胜出。该节注释把胜者写反,不能只看运行结果注释。对组合规则是否可交换、可结合的判断,应回到真实函数定义。

reduceRight对[2,10,60]以除法组合且不传初值时得到(60⁄10)/2;方向不是简单把同一表达式的括号改为右结合,须按实际累计参数顺序推演。

折叠方向影响非交换组合保存独立卡片。

原书依据 · 2 处

7.9.6 indexOf()和lastIndexOf()

索引搜索返回位置或-1,搜索起点决定覆盖范围,重复搜索必须前移。它按严格相等比较,与对象结构相等或NaN匹配不是同一问题。

索引搜索返回位置而非真假

indexOf从给定起点向后找首个匹配位置,lastIndexOf向前搜索,未找到返回-1。因为0也是合法结果,不能直接以返回值真假判断是否找到。按严格相等比较意味着NaN不能被这样匹配,对象需要同一引用而非外观相同。查找全部匹配时,每次记录位置后必须把下次起点移到该位置之后,否则可能重复命中同一项。

索引搜索返回位置而非真假保存独立卡片。

原书依据 · 3 处

7.10 数组类型

识别数组要区分实际数组身份、当前环境的原型关系及可显示的类型标签。不同窗口有各自构造函数,instanceof因而不能作为通用数组识别;示例回退入口Function.isArray是笔误。

跨环境数组识别不能只看原型

不同窗口或frame通常具有各自的Array构造函数和原型,因此来自另一环境的数组可能不满足本环境的instanceof Array。Array.isArray直接回答是否为数组,更符合这一职责。原书回退示例应检查Array.isArray,而不是Function.isArray;借用toString标签是旧环境技巧,现代可定制标签使它不能承担同等的身份保证。

跨环境数组识别不能只看原型保存独立卡片。

原书依据 · 2 处

7.11 类数组对象

类数组是一种按length和索引组织访问的接口形态,不必具有数组的长度维护机制或继承关系。借用数组方法有用,但每个方法对读写、可配置性与参数对象的具体要求仍需满足。

类数组描述访问形态而非身份

类数组对象以长度和数字索引提供按位置访问,常见如arguments或部分DOM集合,但不因具备这些字段就成为真正数组。普通对象不会自动随索引更新length,也不必继承Array.prototype。原书isArrayLike只是基于对象及有限非负整数长度的启发检查,不保证每个索引都存在,更不能证明目标可写或适用于所有数组算法。

类数组描述访问形态而非身份保存独立卡片。

原书依据 · 1 处

借用数组方法要满足读写契约

可通过Array.prototype.slice.call(a,0)等形式把适用数组方法应用于类数组接收者,不要求目标先继承该方法。读取式用途仍需合适的长度和索引数据,修改式用途还需要满足可写与可删除等条件;concat对普通类数组也不默认逐项展开。旧Firefox的Array.join等静态入口不是可移植标准,不应依赖其天然存在或随意修改全局构造函数。

Array.prototype.toString在现行规范中可用于非Array接收者:先取接收者join,可调用就调用,否则用Object.prototype.toString。null/undefined等仍会因对象转换失败抛错,不能据此推断任何接收者都有效。

借用数组方法要满足读写契约保存独立卡片。

原书依据 · 2 处

7.12 作为数组的字符串

字符串提供只读的按索引访问,仍不是数组,索引单位也不等于完整Unicode字符。可借用部分读取式数组方法,但不能用修改式方法把字符串变成可变序列。

可索引字符串仍是不可变值

字符串可通过charAt或方括号读取UTF-16代码单元,Array.isArray仍返回false。适用的读取式数组方法可以借用,但push、sort、reverse等修改式操作不能据此改变原字符串;涉及不可写位置时还可能抛异常,不能沿用原书“出错没有提示”的概括。代码单元索引也不保证对应一个完整字符,按字符处理需另行明确单位。

可索引字符串仍是不可变值保存独立卡片。

原书依据 · 2 处

第8章 函数

函数可以参数化地封装代码,也可以作为值传递并具有自己的属性。方法和构造函数描述调用用途,嵌套函数还可访问定义环境;本章将在这些既有概念上展开调用契约。

函数值可保存与组合关联本项背景,实质主要讲解在对应位置。

作用域链是变量解析的查找链关联本项背景,实质主要讲解在对应位置。

原书依据 · 7 处

8.1 函数定义

声明与表达式都可定义函数,但名字的可见范围与初始化时机不同。命名应表达用途而非靠符号暗示访问控制,return则描述调用的结果或正常结束。

函数声明与表达式初始化不同关联本项背景,实质主要讲解在对应位置。

递归计算要有终止路径关联本项背景,实质主要讲解在对应位置。

return结果与离开函数配对关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

命名函数表达式提供内部自称

命名函数表达式可在自己的函数体内使用该名字引用函数自身,适合递归,而外层接收表达式结果的变量可以是另一个名字。这个内部名字不等于额外声明同名外部变量。它把函数自引用与外部变量的当前取值分开,也不要求所有表达式形式都必须匿名。

旧arguments.callee可供非严格函数递归,但严格函数读取它会抛TypeError,并非普通缺失属性的undefined;优先以命名函数表达式提供自称,避免依赖此旧接口。

命名函数表达式提供内部自称保存独立卡片。

原书依据 · 2 处

函数命名说明用途不提供私有性

函数名应让读者知道它完成什么动作;足够简洁仍要保留关键责任。下划线前缀表示内部用途、小写开头和驼峰或下划线分词,都是约定而不是访问控制。jQuery把常用入口命名为$是特定API选择,不能由此推导所有高频函数都应缩成单字符。

函数命名说明用途不提供私有性保存独立卡片。

原书依据 · 1 处

嵌套函数

嵌套函数可通过词法环境读写外层参数或变量。原书对块内函数声明的禁止描述属于ES5背景,不能作为所有现代JavaScript的统一语法规则。

作用域链是变量解析的查找链关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

8.2 函数调用

函数代码定义后不自动执行,调用可按普通、方法、构造和显式接收者等方式区分。它们会在接收者或结果规则上产生差别,后续逐项处理。

定义函数不执行函数体关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

8.2.1 函数调用

普通调用先对实参表达式求值,再让形参获得传入值。正常结束结果与return一致;this还需按普通函数自身的严格模式和调用形式判断。

return结果与离开函数配对关联本项背景,实质主要讲解在对应位置。

函数模式影响接收者转换关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

8.2.2 方法调用

方法调用通过接收对象提供this,借用同一函数到其他对象也可改变接收者。方法返回对象可支持链式使用,但返回契约应由方法用途确定;嵌套普通函数不会自动继承外层this。

this绑定由调用方式决定而非定义位置

本书普通函数的this由具体调用约定与函数自身模式等决定:o.m()通常把o作为接收者,裸调用在严格与非严格模式下有不同转换,call/apply可显式提供接收值。嵌套普通函数不会仅因写在方法里就自动获得外层this;var self=this把外层接收者保存为普通词法变量供内部函数访问。这是本书普通函数范围的说明,不能推广到箭头函数的词法this或已绑定函数等其他机制。

this绑定由调用方式决定而非定义位置保存独立卡片。

原书依据 · 2 处
链式使用依赖明确的返回契约

链式调用把前一次的返回值作为下一次调用的接收者,因此各步骤必须有兼容的返回契约。以修改当前对象为目的的方法可以约定返回this;转换、查询等方法也可返回不同对象或数据。能链式使用不表示所有方法必须返回自身,更不该为了调用形式改变本来应该表达的业务结果。原书jQuery链中map、get、sort就在不同结果上继续处理。

链式使用依赖明确的返回契约保存独立卡片。

原书依据 · 2 处

8.2.3 构造函数调用

new调用使用新对象作为接收者,哪怕被构造的函数通过属性表达式取得。返回对象可替换默认实例,返回原始值通常不会;省略括号涉及没有实参,不由形参数目决定。

构造返回对象可替换新实例关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

8.2.4 间接调用

call和apply让调用方显式提供接收值,实参传递形态不同:前者逐项,后者以适用的类数组列表组织。能指定this不代表函数会无条件接受所有对象或忽略自身严格转换。

显式接收者与参数展开是两层

call(thisArg,…args)逐项传入实参,apply(thisArg,argsArray)以适用的参数列表对象组织实参,两者都用于显式提供调用接收值。它们不会验证目标对象具备函数所需的全部业务状态,普通非严格函数还会按自身规则处理null或原始值thisArg。因此借用调用能力与函数实际适用范围必须分开;后文将进一步展开接口细节。

参考apply例中的Max.max应为Math.max;Object.prototype.toString.apply(o)只是借用方法调用,不覆写o.toString。apply还可接受适用类数组,null或undefined实参列表表示无实参;thisArg对严格目标函数按原值传递,不总是转全局对象。

call参考末例多了一对括号,正确写法是Object.prototype.toString.call(o);调用现成函数不等于把它安装或覆盖成o的方法。

显式接收者与参数展开是两层保存独立卡片。

原书依据 · 4 处

8.3 函数的实参和形参

普通函数形参数目不自动构成调用校验,形参声明也不提供静态类型约束。函数若需要固定形状或类型,须在具体用途下建立输入契约。

形参列表不自动验证输入契约

本书普通JavaScript函数不会仅因形参列表而拒绝额外实参、补齐业务必需数据或强制检查类型。这个灵活性不等于所有输入都有效:函数内部的操作仍可能转换值、产生错误或得到不符合用途的结果。是否允许省略、接受何种值及如何失败,应由函数自身责任明确,而不是由声明中出现几个名字来替代。

形参列表不自动验证输入契约保存独立卡片。

原书依据 · 1 处

8.3.1 可选形参

省略的形参为undefined,可用显式判断建立默认值。默认策略与位置约定应一致,||会同时覆盖所有假值,参数注释也不是语言访问限制。

默认值或会覆盖合法假值关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处
位置可选参数需约定占位含义

位置参数按实参顺序对应,若要保留后面参数而省略前面位置,可以按函数契约显式传undefined。把可选参数放在末尾通常较易使用,但不是所有接口唯一可能的语言规则。示例getPropertyNames可复用传入数组或创建新数组,返回值应说明是哪一个;/optional/只是文档提示,不会自动验证数组类型。

位置可选参数需约定占位含义保存独立卡片。

原书依据 · 1 处

8.3.2 可变长的实参列表:实参对象

arguments提供本次实参的类数组视图,支持访问未命名的额外值和实参个数。普通非严格ES5参数映射与严格模式不同;零参数是否有效取决于函数用途,不是可变参数函数的普遍禁止。

参数与索引可取消赋值联动关联本项背景,实质主要讲解在对应位置。

调用栈自省接口受到限制关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处
实参对象记录本次传入列表

arguments提供当前普通函数调用的类数组实参列表,arguments.length反映本次实参个数,而不是函数声明中的形参数。它可访问额外实参并支持可变数量调用,但不是自动继承数组方法的真正数组。可变参数函数也可以允许零项:原书max例子在零项时会返回初值负Infinity,是否接受这个结果应由该函数契约决定。

实参对象记录本次传入列表保存独立卡片。

原书依据 · 3 处

8.3.3 将对象属性用做实参

把一组参数放到对象属性中,可用名字替代位置记忆,并给可选项提供约定默认值。三个以上不是强制阈值,包装也不能代替值域和类型校验。

参数对象用名字表达调用意图

easycopy把来源、目标和长度等数据放进一个对象,调用方用属性名说明含义,不必记住多个相似位置参数的顺序。可选项可由包装层补缺省值,但||默认值会覆盖全部假值,不能无条件等同于“未提供”。对象分组改善调用可读性,并不自动验证属性拼写、类型、范围或源目标重叠时的复制规则。

参数对象用名字表达调用意图保存独立卡片。

原书依据 · 1 处

8.3.4 实参类型

实参名称和注释可以说明契约,实际校验仍必须核对所用表达式。sum和flexisum展示拒绝与主动转换两种策略,但前者的isFinite也会转换,后者只拒绝NaN并不拒绝Infinity。

校验可转换不等于已转为数值

sum意图只累计有限数值,但全局isFinite会先进行数值转换,检查通过并未改变原element。若传入数值字符串,随后total+=element仍可能走字符串连接,不能把该示例称为严格数值校验。契约需要分清“原值就是数值”与“允许转换并使用转换结果”,也要明确null和undefined为何被忽略。

校验可转换不等于已转为数值保存独立卡片。

原书依据 · 2 处
宽容求和把转换成本纳入契约

flexisum接受可变实参,对数组递归求和、对函数调用后再转数值、对其他值用Number转换,再拒绝NaN。它展示主动容纳输入的策略,但Infinity仍可能通过,函数求值可有副作用,循环数组也不自动得到终止保证。输入范围越灵活,允许的效果和失败方式越需要明确,不能只把少抛异常当成更健壮。

宽容求和把转换成本纳入契约保存独立卡片。

原书依据 · 1 处

8.4 作为值的函数

函数是可以保存、传递和间接选取的值。用函数参数传入运算,或用名字从函数表中查找运算,都把调用流程与具体行为分开,但查找仍要约束允许成员。

函数值可保存与组合关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

函数表分派仍需限定合法成员

operate2根据操作名从函数表中取出可调用值,使一套入口可以选择不同运算。只检查typeof结果为function并不能证明它就是允许的自有操作,因为属性查找也可能取得原型上的函数;外部输入参与分派时,需要明确函数表成员范围。把函数当数据使行为可组合,却不自动提供授权或输入正确性。

函数表分派仍需限定合法成员保存独立卡片。

原书依据 · 1 处

自定义函数属性

函数自身属性可跨调用保留计数或缓存,降低独立全局变量数量,但状态仍是外部可读写的普通属性。唯一编号与阶乘缓存的演示还具有数值、输入及生命周期限制。

函数作为对象可携带自身持久状态

函数对象可以把计数器或结果缓存保存在自身属性上,让同一个函数对象在多次调用之间共享状态,而不是额外声明多个全局变量。状态仍可被外部读取、修改或重置;换成另一个函数对象也不自动继承这份状态。计数示例不能越过Number精确整数范围继续保证唯一,阶乘缓存也须明确是否接受0、字符串转换或巨大输入。它适合允许可观察共享状态的用途,不等于持久存储或私有字段。

函数作为对象可携带自身持久状态保存独立卡片。

原书依据 · 1 处

8.5 作为命名空间的函数

IIFE建立一次函数调用环境,把临时声明放在局部范围,返回需要暴露的结果。它不使所有状态在返回时消失,也不是现代唯一隔离机制;本书extend补丁的初始化位置还存在不可达代码问题。

IIFE是块级作用域缺失时代的隔离手段

在本书以var和普通函数作用域为主的背景中,立即调用函数表达式可给模块临时变量建立局部环境,并只把所需结果返回出去。局部绑定不会仅因调用结束就全部消失:若返回的闭包仍引用它们,相关状态可以继续存在。现代还有块级绑定和模块等机制,不能把IIFE称为任何版本唯一的隔离手段,也不能认为它消除了未声明赋值或共享对象修改等全部全局影响。

IIFE是块级作用域缺失时代的隔离手段保存独立卡片。

原书依据 · 2 处

特性检测选分支仍需先初始化

例8-3先检测for/in是否枚举toString,再选择普通或补丁版extend,体现按能力选择兼容路径。然而印刷代码把protoprops初始化放在返回补丁函数之后,该赋值无法到达;var声明虽提前,调用补丁仍可能取到undefined。理解兼容意图不能代替检查控制流,应在返回前完成所需状态初始化,再验证两个分支。

特性检测选分支仍需先初始化保存独立卡片。

原书依据 · 1 处

8.6 闭包

闭包保存的是定义时可达的词法绑定关系,调用位置改变不会把查找改成调用者的局部变量。同一次外层调用可让多个闭包共享状态,多次外层调用又可各有独立状态;是否私有取决于实际暴露路径。

this绑定由调用方式决定而非定义位置关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

闭包捕获的是活动作用域链而非快照

本书普通函数通过定义环境解析词法变量,嵌套函数离开外层调用后仍可访问所需绑定;它不是在创建时把各变量值复制成静态快照。同一次外层调用产生的闭包可以共享一个可变绑定,不同调用则可以获得独立绑定。var循环示例中的十个函数共享同一个i,循环结束后都读到10;逐次调用constfunc(i)则使每次调用各有自己的参数v。这里讲的是可观察的绑定语义,不要求引擎必须用普通JavaScript对象保存整条环境链。

结构图:下图表示闭包对状态的引用关系,不是调用顺序或类型继承。

flowchart LR
  A[第一次外层调用] --> B[绑定 n甲]
  C[甲的 count 闭包] -->|读写| B
  D[甲的 reset 闭包] -->|写入| B
  E[第二次外层调用] --> F[绑定 n乙]
  G[乙的 count 闭包] -->|读写| F
  H[乙的 reset 闭包] -->|写入| F

文件上传示例在循环里用var url给多个change闭包共享,稍后回调可能全部使用最后地址;不因每个元素都注册了函数就认为其配置已被复制。

闭包捕获的是活动作用域链而非快照保存独立卡片。

原书依据 · 7 处

闭包实现真正无法绕过的私有状态

把状态保存为外层局部绑定,只暴露读写它的闭包,可以避免外部通过对象属性名直接改写该绑定。addPrivateProperty借此在设置入口集中校验,多个入口也可以共享同一状态。但“无法绕过”必须限定范围:若暴露的值是可变对象,外部可能修改它内部的状态;若方法主动泄露额外引用或提供reset,约束也会随接口改变。闭包不是对不可信代码、所有宿主调试能力或所有数据变化的全面安全保证。

闭包实现真正无法绕过的私有状态保存独立卡片。

原书依据 · 2 处

闭包存取器仍需定义值域

counter(n)的存取器共享参数n,getter返回后递增,setter仅在m>=n时设置。它示范如何把状态从公开属性移到局部绑定,却未自动验证初值与新值是否为合适的有限整数,也不在Number溢出后仍保证唯一。条件允许等于当前值,原书最后一次2000报错源于前面读取已把n递增至2001,不能单独概括为永远禁止相等。

闭包存取器仍需定义值域保存独立卡片。

原书依据 · 1 处

8.7 函数属性、方法和构造函数

函数对象具有自身属性和方法,也可通过Function构造入口创建。后续将区分length、prototype、call/apply、bind和动态构造的责任。

8.7.1 length属性

函数length和arguments.length分别描述定义形状与本次传入个数,不能把两者相等自动当作所有函数的输入合法条件。旧check例子依赖callee,严格模式不适用。

函数形参长度不等于实参个数

本书普通函数的length反映定义中的形参数量,arguments.length反映当前调用实际传入个数。二者不同并不必然是错误,因为可选或可变参数接口本来允许数量不同;检查规则应来自函数用途。原书check通过args.callee.length取期望值,具有严格模式限制,不能作为通用校验器。现代含默认参数等语法时函数length还有额外计数规则,不宜由旧式形参列表直接推断。

函数形参长度不等于实参个数保存独立卡片。

原书依据 · 4 处

8.7.2 prototype属性

本书用普通可构造函数的prototype解释实例继承,但并非每个函数都拥有这一自有属性。后面的绑定函数就是例外,prototype属性与函数对象内部原型也不是同一件事。

原型引用与构造属性分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

8.7.3 call()方法和apply()方法

call/apply显式提供接收值与实参,适合借用函数或包装原方法。临时加属性的说明只是类比,不与真实调用在属性权限、异常清理和副作用上完全等同。

显式接收者与参数展开是两层关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处
方法包装需传递接收者参数结果

trace先保存原方法,再安装包装函数,用original.apply(this,arguments)传递本次接收者与实参,并返回原结果。这样可在不改调用入口的情况下插入日志,但示例原方法抛错时不会执行退出日志;若要记录所有退出须另外设计异常与清理路径。动态替换还会影响共享该对象的方法使用者,不能只当作没有行为风险的观测动作。

方法包装需传递接收者参数结果保存独立卡片。

原书依据 · 2 处

8.7.4 bind()方法

bind建立新函数,普通调用时固定接收者并预置前段实参;后面的调用值接在预置值之后。标准绑定函数还有构造规则,原书简化闭包不能完整模拟。

预置实参与绑定接收者分开

bind(thisArg,…boundArgs)返回新函数,普通调用时使用预先给定的接收值,并把预置实参放在本次实参之前。额外绑定实参不是再次“绑定到this”,而是固定参数前缀。这属于部分应用;原书把它宽泛称为柯里化,但柯里化严格指把多参数函数转成逐层单参数函数,二者不应直接等同。

预置实参与绑定接收者分开保存独立卡片。

原书依据 · 3 处
绑定函数构造不使用绑定接收值

当原目标可构造时,标准bind结果也能按构造调用:预置实参仍参与,而预绑定thisArg被忽略,由构造过程建立接收对象。绑定结果通常没有自己的prototype属性,实例原型规则来自原目标;这说明函数可调用、可构造与具有某个同名属性不能机械画等号。仅用apply返回闭包的简化bind不能完整模拟这些构造语义。

绑定函数构造不使用绑定接收值保存独立卡片。

原书依据 · 2 处
闭包式绑定垫片只覆盖部分行为

例8-5把原函数与绑定阶段的arguments保存在外层局部变量中,返回的闭包再拼接预置和本次参数并用apply调用。这是保存环境并延迟执行的清晰例子,但不能完整复现原生绑定函数的length、构造调用及相关反射行为。兼容实现应明确支持范围,不因普通调用示例通过就宣称全部语义相同。

闭包式绑定垫片只覆盖部分行为保存独立卡片。

原书依据 · 1 处

8.7.5 toString()方法

函数toString可显示与函数表示相关的文本,内置函数可能只有native code标记。显示内容不包含词法环境绑定,不能据此当成完整可恢复的闭包。

函数文本不保存闭包环境

函数toString可用于观察函数文本,内置函数往往显示native code而非实际实现。即使得到普通函数的源文本,也没有一并取得它所引用的词法绑定及运行状态,不能据此完整序列化和恢复原闭包。它与Object.prototype.toString的类型标签职责也不同,应先确认实际调用的是哪个方法。

函数文本不保存闭包环境保存独立卡片。

原书依据 · 2 处

8.7.6 Function()构造函数

Function构造器把字符串解析成函数,但使用构造器所在环境的全局作用域关联,不捕获当前调用点的局部变量。它仍有定义环境,只是不同于局部函数表达式。

动态函数不捕获调用点局部绑定

Function构造器在运行时从字符串创建函数,示例中构造地点的局部scope不会被捕获,之后读取的是构造器所关联全局环境中的scope。这不等于语言全面改用动态作用域,而是创建方式选择了不同的定义环境。动态解析也需要承担语法错误、数据进入代码和宿主限制等问题;它不能当作普通局部闭包的等价写法。

动态函数不捕获调用点局部绑定保存独立卡片。

原书依据 · 2 处

8.7.7 可调用的对象

可调用能力描述对象是否能作为调用目标,而不是只看某个展示标签。旧宿主方法与可调用正则属于历史兼容材料,不能移作当前可移植接口规则。

可调用能力不能靠标签绝对证明

本书用旧IE宿主方法和旧浏览器可调用RegExp说明:能出现在调用位置,不必在旧实现中都表现为普通Function对象。这个历史区别有助于理解能力与外观标签不同,但不应依赖非标准正则调用。原书isFunction按toString标签检测也不是现代不可伪造的调用能力证明,不能直接当作不可信输入的安全判断。

可调用能力不能靠标签绝对证明保存独立卡片。

原书依据 · 1 处

8.8 函数式编程

函数可作为值传递、组合并作用于数据序列,使JavaScript能够使用函数式风格。本节是后面高阶函数与部分应用的引导,不要求把语言排他地归进单一范式。

8.8.1 使用函数处理数组

平均值和标准差可分为求和、求偏差、平方和与开方的变换步骤,再用map与reduce组合。旧版兼容函数意图复现这些步骤,但印刷实现对空槽和首成员边界并不完全正确。

样本离散程度按偏差平方累计

本例先求平均值,再把各项减去均值所得偏差平方求和,最后除以n−1并开方,计算的是常见样本标准差形式。数据[1,1,3,5,5]的均值为3,偏差平方和为16,除以4后开方得2。这里需要有效数值数据且n至少为2;不能把空输入、单项或含空槽时仍按length计数的结果当同一统计含义。

样本离散程度按偏差平方累计保存独立卡片。

原书依据 · 1 处
数组计算可拆成变换与折叠

本例以map表达各数据到偏差及平方的逐项转换,以reduce表达累计求和,再做归一化和开方。它把每步意图写成可组合操作,便于看清数据怎样流动;但不自动保证回调纯净,也不代表一定更节省中间数组或执行时间。选择这种风格应先保持输入约束和数学含义一致。

数组计算可拆成变换与折叠保存独立卡片。

原书依据 · 2 处
兼容遍历要核对空槽与边界

本节手写map只在发现成员时写入results,没有显式保存输入长度,尾部空槽或全空槽输入可丢失预期长度。手写reduce寻找首成员时先执行i++,随后用i==len抛错,可能把唯一成员恰在末尾的有效输入误判为无成员。兼容代码即使注明“来自规范”,仍应逐项核对边界,而不是以普通稠密示例代替完整语义。

兼容遍历要核对空槽与边界保存独立卡片。

原书依据 · 1 处

8.8.2 高阶函数

高阶函数以函数为参数或结果,本节的not、mapper、compose同时展示了接收与返回函数的情形。转换函数可封装既有行为,但需要保持参数、接收者和返回值衔接的具体契约。

高阶函数操作可复用行为

高阶函数把函数当作输入或结果来操作,不要求必须同时接收函数并返回函数。not包装判定函数并对其结果取逻辑非,mapper把单项变换提升为数组变换;它们用闭包保留原行为,生成另一种可复用行为。是否短路、是否改变输入或是否保留this,仍需检查具体实现,不能仅由“高阶”标签推断。

高阶函数操作可复用行为保存独立卡片。

原书依据 · 1 处
函数组合需衔接输入输出

compose(f,g)生成的函数先把本次全部实参传给g,再把g的单个返回结果传给f,并在本例中把调用接收者传给两者。顺序是f(g(…)),不是先执行f;g的结果也不会自动作为多个参数展开。组合能复用步骤,但相邻输入输出必须兼容,异常或副作用也仍沿真实调用发生。

函数组合需衔接输入输出保存独立卡片。

原书依据 · 1 处

8.8.3 不完全函数

部分应用预置一部分实参,使后续调用补齐其他位置。本节分别实现左侧、右侧和undefined模板填充,它们保留调用时this,不能与bind固定this的全部语义或数学部分函数概念混同。

预置实参与绑定接收者分开关联本项背景,实质主要讲解在对应位置。

数组计算可拆成变换与折叠关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处
部分应用需明确填参位置

partialLeft预置左侧参数,partialRight预置右侧参数,partial按模板中的undefined位置依次填入本次实参,再追加剩余实参。本例f(x,y,z)=x(y-z),左置2得到2(3−4)=−2,右置2得到3(4−2)=6,中间预置2得到3(2−4)=−6。预置位置改变实际计算,不能把这些变换视作同一种绑定。模板把undefined当占位符,也就无法同时无歧义地表示该位置要固定为undefined。

部分应用需明确填参位置保存独立卡片。

原书依据 · 1 处

8.8.4 记忆

记忆化把函数输入映射到已算结果,重复输入可复用,但缓存键和函数依赖必须一致。本节字符串键的实现只在严格前提下有效,最大公约数与递归阶乘则展示缓存如何参与实际调用。

递归计算要有终止路径关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处
记忆化复用依赖相同的计算含义

记忆化包装函数在闭包中保存输入到结果的缓存,命中时直接返回,未命中才调用原函数并保存结果。它以空间与缓存维护成本换取避免重复计算的机会;若函数依赖时间、随机性、可变外部状态或调用this,相同显式实参未必代表相同计算。结果本身若可变,缓存还会反复返回同一对象,不能把这种复用当作每次独立新建。

记忆化复用依赖相同的计算含义保存独立卡片。

原书依据 · 1 处
字符串缓存键必须避免碰撞

本例把实参数量与逗号连接的字符串用作缓存键,但不能区分所有不同输入。两个实参(“a,b”,“c”)与(“a”,“b,c”)都会形成相同拼接形态;不同类型或对象也可能转成同样文本,this更没有进入键中。因此该实现必须限制输入与依赖范围,不能直接当成任意函数的通用缓存器。命中使用in还涉及原型成员,不能凭普通样例忽略键空间规则。

字符串缓存键必须避免碰撞保存独立卡片。

原书依据 · 1 处
余数迭代逐步缩小公约数问题

对适用的非负整数,欧几里德算法反复把(a,b)换成(b,a%b),直到b为0,此时a为最大公约数。示例85与187先调整次序,187除以85余17,85除以17余0,故结果为17。算法依赖合适整数输入,原文明确省略类型检查,不能拿这段演示处理任意浮点数或非法值。

结构图:

flowchart TD
  A[接收两个合格整数] --> B[按需要交换先后]
  B --> C{第二数为零}
  C -->|是| D[返回第一数]
  C -->|否| E[计算第一数除第二数的余数]
  E --> F[第二数成为第一数 余数成为第二数]
  F --> C

余数迭代逐步缩小公约数问题保存独立卡片。

原书依据 · 1 处

第9章 类和模块

本章把原型共享、构造初始化、类型判断、继承与模块联系起来。这里的类主要指本书ES5时代的原型组织模型,不能直接把“同一个原型”升格为所有现代类型判断的唯一规则。

原型引用与构造属性分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

9.1 类和原型

range工厂显式创建继承共享方法对象的实例,再给实例设置边界状态。每个实例的from/to是各自自有属性,但别的对象仍可把该实例当原型继承这些属性,不能说它们天生不可继承。

实例状态与共享行为分开

range(from,to)先用inherit(range.methods)建立对象,再把边界值存到该对象的自有from和to。includes、foreach和toString共享在原型对象上,调用时通过this读取具体接收者状态;因此共享方法不必把每个实例的边界也放到同一个共享位置。自有状态并不具有永久“不可继承”属性,后来创建的派生对象仍可能继承它。

结构图:类图表达本例代码对象的职责关系;工厂函数不是类型,范围对象为原书未单独命名的实现示意。实线箭头为原型引用,虚线为创建或使用依赖。

classDiagram
  class rangeFactory["range(工厂函数,非类型)"] {
    +range(from, to) Object
  }
  class rangeMethods["range.methods(原型对象)"] {
    +includes(x) Boolean
    +foreach(f) undefined
    +toString() String
  }
  class RangeObject["范围对象实现(示意)"] {
    from
    to
  }
  rangeFactory ..> RangeObject : 创建并设置状态
  rangeFactory ..> rangeMethods : 使用共享方法对象
  RangeObject --> rangeMethods : 原型引用

实例状态与共享行为分开保存独立卡片。

原书依据 · 1 处

9.2 类和构造函数

把工厂改为Range构造函数后,new承担对象创建,构造函数初始化this,约定prototype提供共享行为。名字大写仅是提示,示例末尾仍写range(1,3)是未同步的旧调用。

工厂创建与构造初始化分工不同

工厂range显式创建并返回对象;本例Range(from,to)作为构造函数使用时,由new先建立接收对象,再初始化this.from和this.to,原型来自当次构造采用的Range.prototype。两种方式可提供相同实例方法,但创建责任不同。原书例9-2末尾仍写var r=range(1,3),若要展示新构造方式应为new Range(1,3),不能把旧调用当已验证的新示例。

工厂创建与构造初始化分工不同保存独立卡片。

原书依据 · 1 处

9.2.1 构造函数和类的标识

本书以共享原型定义原型式类的归属,构造函数只是创建与公开识别的入口。instanceof检查指定原型关系而非历史调用记录;这套说明不等于任意现代类语义的唯一标准。

原型才是类的真正标识

在本书的普通原型式类模型中,实例共享哪一个原型比构造函数叫什么更基础。两个构造函数可指向同一prototype对象,同一个构造函数也可在更换prototype前后产生不同原型的实例。普通instanceof检查目标构造函数所指定的原型是否在实例链上,不核验它是否真的执行过初始化。这里的“唯一标识”限于本书模型;现代可定制instanceof及其他类型机制不能由这句话一并概括,原型链上更高层关系也不等于只有一种类归属。

原型才是类的真正标识保存独立卡片。

原书依据 · 3 处

9.2.2 constructor属性

预定义prototype通常有指回构造函数的constructor,实例可通过继承读到它。整块替换原型会改变这个约定,但未必意味着完全没有constructor;新对象还可继承Object.prototype.constructor。

构造属性不能可靠反推原型关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处
构造反向引用是可变约定

普通构造函数预定义的prototype通常自有一个不可枚举constructor指回该函数,实例可继承它。用新字面量替换整个prototype会丢掉原来的自有反向引用,却可能仍继承Object的constructor;显式补写constructor可恢复约定,但字面量添加默认可枚举性与原属性不同。给原有prototype逐项增加方法则可保留原反向引用。constructor仍是可改的属性,不能据它可靠证明对象的创建历史。

结构图:图9-1已查看。类图表示引用约定而非名义类继承;Range为构造函数而非类型,实例为实现示意。虚线表示创建依赖,实线表示属性或原型引用。

classDiagram
  class RangeCtor["Range(构造函数,非类型)"] {
    +Range(from, to)
  }
  class RangeProto["Range.prototype(原型对象)"] {
    +includes(x) Boolean
    +foreach(f) undefined
    +toString() String
  }
  class RangeInstance["范围实例实现(示意)"] {
    from
    to
  }
  RangeCtor --> RangeProto : prototype 属性
  RangeProto --> RangeCtor : constructor 约定
  RangeCtor ..> RangeInstance : new 创建初始化
  RangeInstance --> RangeProto : 原型引用

构造反向引用是可变约定保存独立卡片。

原书依据 · 1 处

9.3 JavaScript中Java式的类继承

本书把构造函数对象、原型对象和实例对象映射为静态成员、共享实例方法与独立状态。Complex演示复数值及操作,但命名约定、校验和解析都不能比实际代码承诺更多。

校验可转换不等于已转为数值关联本项背景,实质主要讲解在对应位置。

构造属性不能可靠反推原型关联本项背景,实质主要讲解在对应位置。

原书依据 · 7 处

三层对象映射传统类成员概念

在本书ES5组织方式中,构造函数对象上的属性承载类级字段和操作,prototype对象上的函数承载可继承的实例行为,实例自有属性保存各自状态。属性值为函数时可作为方法调用,但位置和调用方式仍决定实际用途。实例各有属性并不保证属性值引用的对象互不共享,静态成员也不自动被实例按属性继承。这里是旧式原型组织映射,不代表现代JavaScript没有class语法或私有成员机制。

结构图:类图中的Complex是构造函数而非类型,实例为原书实现示意;实线表示属性或原型引用,虚线为创建依赖。

classDiagram
  class ComplexCtor["Complex(构造函数,非类型)"] {
    +Complex(real, imaginary)
    ZERO
    ONE
    I
    +parse(s) Object
  }
  class ComplexProto["Complex.prototype(原型对象)"] {
    +add(that) Object
    +mul(that) Object
    +mag() Number
    +neg() Object
    +toString() String
    +equals(that) Boolean
  }
  class ComplexObject["Complex实例实现(示意)"] {
    r
    i
  }
  ComplexCtor --> ComplexProto : prototype 属性
  ComplexCtor ..> ComplexObject : 创建初始化
  ComplexObject --> ComplexProto : 原型引用

三层对象映射传统类成员概念保存独立卡片。

原书依据 · 1 处

复数以实部虚部配对运算

Complex用r和i保存实部与虚部,表示r+i·√−1。加法分别相加两个分量;乘法的实部为r₁r₂−i₁i₂,虚部为r₁i₂+i₁r₂;模是√(r²+i²),求负对两个分量取相反数。示例运算返回新的Complex对象而非直接修改接收者,但输入表示仍基于Number,不能推断任意大或极小数的数值稳定性。

复数以实部虚部配对运算保存独立卡片。

原书依据 · 1 处

常量命名不冻结被引用对象

ZERO、ONE、I用大写表达常量意图,但本例只是把可变对象赋给构造函数普通属性。名称不会阻止属性被重新赋值,也不会阻止通过该引用修改对象内部r和i;下划线前缀同样不自动使_format私有。应把命名约定、引用不可重赋与被引用对象不可变分开,实际限制要由相应封装或描述规则提供。

常量命名不冻结被引用对象保存独立卡片。

原书依据 · 2 处

格式解析成功不等于完整验证

Complex.parse先用外形正则提取两个片段,再用parseFloat转数值,失败时统一抛类型错误。正则并未严格验证完整数值语法,parseFloat还可接受数字前缀,所以不能把成功解析视为原输入全体字符都满足数值协议。统一异常方便调用方识别失败,也可能抹去内部故障差别,应明确格式与值域契约。

格式解析成功不等于完整验证保存独立卡片。

原书依据 · 1 处

9.4 类的扩充

修改现有原型可使尚未遮蔽对应名字的实例获得新行为,但这不同于给构造函数替换整个prototype。扩展全局原型还会影响枚举与其他代码,不可枚举也不能免除全部兼容风险。

原型扩展影响现有查找路径

向已有Complex.prototype增加conj后,仍继承该对象且未遮蔽conj的实例可以通过查找链获得新方法。若把构造函数的prototype整个换成另一个对象,既有实例却不会自动改连新对象。扩展与替换作用不同;对内置原型作修改还会改变其他使用者可见的成员,因此需要明确影响范围和命名冲突,而非把动态可扩展视为无条件安全。

原型扩展影响现有查找路径保存独立卡片。

原书依据 · 1 处

复共轭保持实部反转虚部

本例conj返回一个新复数对象,保留原复数实部r并取虚部i的相反数,这就是复共轭。它通过给现有原型添加方法,使同一表示获得新操作,并未要求修改每个实例保存的状态。该例说明可在共享行为层扩展运算,不意味着所有原型修改都具有相同兼容性。

复共轭保持实部反转虚部保存独立卡片。

原书依据 · 1 处

9.5 类和类型

typeof、内部标签、原型关系、constructor及名字回答不同分类问题。此处引入多种检查路线,最后将转向关心对象实际能力的鸭式类型。

9.5.1 instanceof运算符

instanceof和isPrototypeOf都围绕原型链关系,但入口不同;跨窗口同名构造函数不是同一个对象,因此本地构造函数不能通用识别其他环境实例。

原型才是类的真正标识关联本项背景,实质主要讲解在对应位置。

跨环境数组识别不能只看原型关联本项背景,实质主要讲解在对应位置。

原型链成员检测不检查自身关联本项背景,实质主要讲解在对应位置。

原书依据 · 8 处

9.5.2 constructor属性

constructor可用于约定式分派,但可缺失、被遮蔽或改写,也受到跨环境身份差异影响。case后比较的是函数对象,不是函数名字字符串。

构造属性不能可靠反推原型关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

9.5.3 构造函数的名称

构造函数名可用于诊断显示,却不具唯一性与稳定性;同名函数可有不同职责,无名表达式也可能从上下文获得名字。名称提取策略不能替代身份或能力验证。

函数名适合显示不适合身份认证

用构造函数名字作字符串标签,可能绕开跨窗口函数对象不相等的问题,却引入同名冲突、重命名和可改显示信息等限制。现代function.name已是标准属性,匿名表达式也可因定义上下文获得名字,不能照旧书判为永远空字符串。根据源码正则提取函数名还依赖语法形态,适合受限诊断,不应成为不可信对象身份或权限依据。

函数名适合显示不适合身份认证保存独立卡片。

原书依据 · 1 处

9.5.4 鸭式辩型

鸭式类型关注使用方需要的行为,而非只看构造来源。行为契约可能包括运算和状态变化,不仅是同名方法存在;quacks只能检查部分表面形态,不能证明完整正确性。

鸭式辩型关注能做什么而非是什么

鸭式类型从使用者需要的操作出发:对象不必来自同一构造函数,只要满足所需能力和行为契约即可。例如按length读取的算法可能接受类数组,而依赖自动截断的算法不能仅检查有一个length。检查同名属性为函数,可提前发现部分错误,却不能证明参数、返回值、状态改变或其他行为符合要求。因此能力导向并不是取消契约,也不使所有名义类型检查一概无用。

鸭式辩型关注能做什么而非是什么保存独立卡片。

原书依据 · 1 处
方法枚举检查不能验证完整接口

quacks按字符串检查方法名,或用for/in枚举一个样板对象的函数属性,再看目标是否有同名函数。它会受样板可枚举性与继承成员影响,不能覆盖内置原型中不可枚举的方法,也不检验参数和语义。若没有枚举到要求,返回true可能只是没有发现反例,不是目标已实现完整接口的证据。

方法枚举检查不能验证完整接口保存独立卡片。

原书依据 · 1 处

9.6 JavaScript中的面向对象技术

这一段从基础关系转向集合和枚举等具体例子,为后面的转换、比较、借用方法与私有状态提供共同背景。

9.6.1 一个例子:集合类

本书Set以对象存储成员、用计数记录大小,再把不同JavaScript值编码为键。这个自定义教学实现不是现代内置Set,其对象身份键需要写入成员对象,存在明显适用限制。

集合以唯一成员维护数量

集合表达不重复成员的无序收集:重复添加已有成员不增加大小,删除不存在成员也不减少大小。示例用对象保存键到原值的映射,再用n维护成员数量,add和remove返回this以支持链式修改,contains返回是否成员,size返回数量。不同返回值分别表达修改接口和查询结果,不能把contains误当成返回成员本身。

集合以唯一成员维护数量保存独立卡片。

原书依据 · 1 处
集合键需区分类别与对象身份

示例先给undefined、null与布尔值专门短码,再为数字和字符串使用不同前缀,防止数值3与字符串”3”混成同一个成员。对象和函数则需要身份编号,同一对象复用编号、不同对象使用不同编号,而不是比较对象外观。它是在ES5值域上的教学编码,现代新增值类别不能直接落入原来的默认对象分支;集合等价关系也应按实际编码明确。

集合键需区分类别与对象身份保存独立卡片。

原书依据 · 1 处
给对象写身份号会产生额外约束

objectId在成员对象上写入特殊名字的编号,即使只做contains查询也可能触发这次写入。不可扩展或只读对象、已有同名属性、被外部修改的编号,以及失效的hasOwnProperty入口,都会破坏其“稳定唯一”假设。原文注释说编号在ES5不可枚举且只读,但实际这里只有普通赋值,并未设置相应描述符,不能把意图当成已经实施的权限。

给对象写身份号会产生额外约束保存独立卡片。

原书依据 · 2 处
集合实现由成员表计数和编码协作

本例Set实例保存values成员表与n计数,原型方法通过_v2s取得键,再查验或修改成员表,并同步计数。foreach只把自有存储项的原值交给回调,还可指定其接收者。集合正确性因此同时依赖键编码稳定、成员检测范围和计数与存储一致,不是仅有一个对象就自动得到任意值集合。

结构图:Set是本书自定义构造函数,非现代内置Set;实例实现为示意。实线表示属性或原型引用,虚线为创建、调用依赖。

classDiagram
  class SetCtor["Set(构造函数,非类型)"] {
    +Set()
  }
  class SetObject["Set实例实现(示意)"] {
    values
    n
  }
  class SetProto["Set.prototype(原型对象)"] {
    +add() Object
    +remove() Object
    +contains(value) Boolean
    +size() Number
    +foreach(f, context) undefined
  }
  class KeyFn["Set._v2s(函数,非类型)"] {
    +_v2s(val) String
    next
  }
  SetCtor ..> SetObject : 创建初始化
  SetObject --> SetProto : 原型引用
  SetCtor --> KeyFn : _v2s 属性
  SetProto ..> KeyFn : 成员键编码

集合实现由成员表计数和编码协作保存独立卡片。

原书依据 · 1 处

9.6.2 一个例子:枚举类型

枚举工厂集中建立有限命名值,并提供字符串、数值和JSON表示。扑克牌例子再用花色和点数组合牌组,比较、洗牌与发牌各自有不同契约;示例没有自动把枚举或牌组冻结。

枚举值由工厂集中建立

enumeration从名称到值的映射建立一组共享原型的枚举对象,再返回一个会拒绝普通构造的标识函数。名称、数值转换、JSON名称表示和values枚举表使调用方能按统一方式使用这些值。但抛错的构造入口并不自动冻结所有值或阻止另外建立相似派生对象,工厂本身也需限制输入映射的继承成员、冲突名字及可修改状态。

结构图:本图限定Coin/Card所用的数值枚举,通用工厂未强制数值值域。两个函数节点分别为工厂与返回的虚拟构造函数,均不是类型;枚举对象为实现示意。虚线为创建或返回依赖,实线为属性或原型引用。

classDiagram
  class EnumFactory["enumeration(工厂函数,非类型)"] {
    +enumeration(namesToValues) Function
  }
  class EnumCtor["返回的枚举标识函数(非类型)"] {
    values
    +foreach(f, c) undefined
  }
  class EnumProto["proto(枚举原型对象)"] {
    +toString() String
    +valueOf() Number
    +toJSON() String
  }
  class EnumObject["枚举值实现(示意)"] {
    name
    value
  }
  EnumFactory ..> EnumCtor : 创建并返回
  EnumFactory ..> EnumObject : 集中创建
  EnumCtor --> EnumProto : prototype 属性
  EnumObject --> EnumProto : 原型引用

枚举值由工厂集中建立保存独立卡片。

原书依据 · 1 处
牌组组合牌面并按位置发牌

Card实例用suit和rank表示牌面,Deck把所有花色与点数组合成cards数组。deal(n)从尾部移出n张并返回被删除的数组,因此牌组自身会缩短;牌面按点数比较与按花色再点数比较则是不同排序用途。示例只检查剩余数量不足,没有完整验证n为非负整数,不能把演示直接当成全输入合法的发牌接口。

结构图:构造函数与实例示意分开;虚线为创建依赖,菱形表示牌组通过cards保存多张牌面对象。

classDiagram
  class CardCtor["Card(构造函数,非类型)"] {
    +Card(suit, rank)
    +orderByRank(a, b) Number
    +orderBySuit(a, b) Number
  }
  class CardObject["Card实例实现(示意)"] {
    suit
    rank
  }
  class DeckCtor["Deck(构造函数,非类型)"] {
    +Deck()
  }
  class DeckObject["Deck实例实现(示意)"] {
    cards
  }
  class DeckProto["Deck.prototype(原型对象)"] {
    +shuffle() Object
    +deal(n) Array
  }
  CardCtor ..> CardObject : 创建牌面
  DeckCtor ..> DeckObject : 创建牌组
  DeckCtor ..> CardCtor : 组合花色和点数
  DeckObject o-- CardObject : cards 保存
  DeckObject --> DeckProto : 原型引用

牌组组合牌面并按位置发牌保存独立卡片。

原书依据 · 1 处
洗牌逐步固定随机交换的位置

本例从末尾向前,对当前位置i在0到i之间选一个随机位置并交换,随后不再改变已处理的尾部位置。这是逐步缩小候选范围的洗牌机制,代码并未寻找“最小牌面”。若每一步选择独立均匀,可得到相应均匀排列;这个条件不能由“用了Math.random”就当作已验证的实际随机质量。

结构图:

flowchart TD
  A[当前位置设为末尾] --> B{当前位置大于零}
  B -->|否| C[返回原牌组]
  B -->|是| D[从零到当前位置随机选一项]
  D --> E[交换两处牌面]
  E --> F[当前位置减一]
  F --> B

洗牌逐步固定随机交换的位置保存独立卡片。

原书依据 · 1 处

9.6.3 标准转换方法

对象转换接口有不同职责:可读文本、本地化显示、可选原始值及JSON替代数据。集合适合用值数组表达JSON,而不是把内部成员表和计数直接当稳定交换协议。

对象转换方法有不同职责关联本项背景,实质主要讲解在对应位置。

序列化钩子返回的是替代值关联本项背景,实质主要讲解在对应位置。

原书依据 · 7 处
集合序列化应表达成员而非内部表

本书Set的toArray用foreach收集成员,toJSON复用它,让外部数据反映集合中的值而非values编码与n等实现细节。普通JSON解析只会得到数组,不会自动恢复Set原型、成员唯一约束或嵌套对象类型。文本展示与稳定交换表示是不同职责,还应明确集合无序性对输出次序的影响。

集合序列化应表达成员而非内部表保存独立卡片。

原书依据 · 1 处

9.6.4 比较方法

对象身份相等、类自定义值相等与排序中的等价可能不同。比较方法要明确类型和值域,排序返回0与equals的约定若不一致,可能使后续使用者误判同一性。

排序比较需表达一致先后关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处
对象值相等由明确的契约定义

对象的严格相等比较引用身份,不会自动逐属性比较;自定义equals可以按类用途定义值相等。Range例子比较两个端点,Set先比较大小再核对成员覆盖。构造属性或instanceof只是这些示例选择的接受范围,不能自动替代值域或不可伪造身份保证。关系运算符还可能先做原始值转换,不能把对象的大小比较也说成单纯引用身份比较。

对象值相等由明确的契约定义保存独立卡片。

原书依据 · 1 处
排序等价应与预期相等协调

若Range.compareTo只比较from,两个起点相同但终点不同的范围会返回0,而按双端点的equals仍为false。原书增加终点作为第二比较维度,让排序等价更贴近其值相等契约。这个策略仍需约定可比较的数值范围;NaN、非数值、不同类型与接受子类的规则都可能破坏“当且仅当”保证,不能只看两个减法便断言所有输入都一致。

排序等价应与预期相等协调保存独立卡片。

原书依据 · 1 处
集合相等可由等大与成员覆盖判定

对采用相同成员等价规则的有限集合,先确认大小一致,再验证本集合每项都在另一个集合中,可判定成员相同。本例用foreach遍历,遇到缺项抛专用false信号停止,并只把这个信号解释为不相等,其他异常继续抛出。它是在特定接口下实现提前结束,不意味着任意运行异常都应被吞成false。

集合相等可由等大与成员覆盖判定保存独立卡片。

原书依据 · 1 处

9.6.5 方法借用

方法借用让不同对象复用同一个函数,并不复制出另一个独立函数或建立完整多重继承。通用equals还需要双向成员和等价规则,原书的单向遍历可能误判。

借用方法仍依赖接收者契约

把同一个函数赋给另一对象或原型的属性,可以复用方法实现;这并不复制函数,也不自动建立另一个原型继承分支。借用函数仍按本次this读取需要的成员,接收对象必须满足相应行为和状态要求。Set的toJSON与toArray引用同一个函数,就展示接口别名不等于两个独立实现。

借用方法仍依赖接收者契约保存独立卡片。

原书依据 · 1 处
通用浅比较需核对双向成员

generic.equals只遍历this的可枚举自有成员,再读取that的同名值,可能忽略that多出的成员,也未保证that对应名字是自有属性。比如同构造约定下{x:1}与{x:1,y:2},单向遍历可能给出不对称判断。它还不覆盖不可枚举属性或深层值相等;“通用”名字不能替代明确的成员集合与等价契约。忽略集合身份号只是一项特殊处理,不使其他情况自动正确。

通用浅比较需核对双向成员保存独立卡片。

原书依据 · 1 处

9.6.6 私有状态

闭包可把端点绑定保存在构造调用环境,再给每个实例设置自己的读取函数。原型方法借助这些函数读状态;外部替换访问入口仍可改变可见行为,封装不自动等于不可变。

闭包实现真正无法绕过的私有状态关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处
闭包访问函数属于各个实例

本例Range不再把端点直接放在可读取的数据属性中,而是把from、to保存在构造调用的参数绑定里,给每个实例创建两个读取闭包。共享原型方法再通过this.from()和this.to()取得端点,因此私有状态与共享行为仍可协作。读取函数自身若是可写属性,外部可替换它们而改变可观察范围;端点若为可变对象,内部也不自动深冻结。

结构图:Range为构造函数,非类型;实例是实现示意。虚线为创建依赖,实线为原型引用,方法中的状态访问经实例读取函数完成。

classDiagram
  class RangeCtor["Range(构造函数,非类型)"] {
    +Range(from, to)
  }
  class RangeInstance["闭包端点Range实例实现(示意)"] {
    +from() 端点值
    +to() 端点值
  }
  class RangeProto["Range.prototype(原型对象)"] {
    +includes(x) Boolean
    +foreach(f) undefined
    +toString() String
  }
  RangeCtor ..> RangeInstance : 每次创建读取闭包
  RangeInstance --> RangeProto : 原型引用

闭包访问函数属于各个实例保存独立卡片。

原书依据 · 2 处

9.6.7 构造函数的重载和工厂方法

初始化可根据参数形态分派,也可用命名工厂区分语义;前者省入口名却可能使数组整体与数组成员列表发生歧义。共享原型的辅助构造也只是一种创建约定。

原型才是类的真正标识关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处
形态重载可能混淆整体与成员

Set构造器若把唯一类数组参数解释为一批待加入成员,就难以同时用相同调用形式表示“把这个数组本身作为一个成员”。它不是简单的参数数量问题,而是相同形态承担两种语义。可显式建立空集合再添加整体对象,或另设命名工厂表达不同初始化用途;具体选择应使调用意图可辨。

形态重载可能混淆整体与成员保存独立卡片。

原书依据 · 1 处
命名工厂区分初始化语义

Complex.polar(r,theta)用半径和角度计算实部r·cosθ、虚部r·sinθ,再建立复数;Set.fromArray(a)则把数组解释为成员来源。两者通过入口名字说明输入含义,而不是让相同两个数字或一个数组在构造器里隐式猜测。工厂仍应验证实际值域,返回新对象也不自动保证深复制或输入没有共享引用。

命名工厂区分初始化语义保存独立卡片。

原书依据 · 1 处

9.7 子类

子类可沿原型关系继承行为、覆写方法并按需调用父实现;构造初始化的委派与方法查找又是两件事。抽象方法用来表达必须由具体实现补齐的能力。

原型链子类化的固定范式关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

抽象接口由具体实现补齐

抽象类在本书中承担共同接口与复用行为的约定,其抽象方法把需要实现的操作留给具体子类。不能因此认为抽象类中的所有方法都必须没有实现,也不能只因名字叫Abstract就假定JavaScript运行时自动禁止实例化。后文将用显式函数和继承层次展示如何表达这些限制。

抽象接口由具体实现补齐保存独立卡片。

原书依据 · 2 处

9.7.1 定义子类

手工子类化让子原型继承父原型,再按约定恢复constructor并设置方法。SingletonSet还说明:子类可以有完全不同的内部状态,而无需调用父构造初始化本来不会用到的存储。

原型链子类化的固定范式

本书普通函数的手工子类化通常建立“实例→子原型→父原型”的查找链;constructor反向引用可另外恢复,但它不是原型查找生效的必要条件。是否调用父构造取决于子实现所需状态:SingletonSet只保存member并重写核心存储接口,没有初始化Set的values与n,却可继承基于接口的通用方法。因而“必须固定三步缺一不可”过强,ES2015 class/super也不宜直接描述为这几行代码的精确文本替换。

结构图:展示具体例子的原型对象链;SingletonSet是构造函数而非类型,实线是对象间原型引用,不是名义类型证明。

classDiagram
  class SingletonCtor["SingletonSet(构造函数,非类型)"] {
    +SingletonSet(member)
  }
  class SingletonObject["SingletonSet实例实现(示意)"] {
    member
  }
  class SingletonProto["SingletonSet.prototype(原型对象)"] {
    +add()
    +remove()
    +size() Number
    +foreach(f, context) undefined
    +contains(x) Boolean
  }
  class SetProto["Set.prototype(父原型对象)"] {
    +toString() String
    +toArray() Array
    +equals(that) Boolean
  }
  SingletonCtor ..> SingletonObject : 创建member状态
  SingletonObject --> SingletonProto : 原型引用
  SingletonProto --> SetProto : 原型引用

原型链子类化的固定范式保存独立卡片。

原书依据 · 2 处
子类替换要保持成员等价契约

SingletonSet的contains采用严格相等,而父Set以_v2s编码成员;两者不一定给所有值同样的等价结果。例如父实现可把NaN编码为同一键,严格相等却无法让NaN匹配自身,继承或覆写equals就可能出现不同方向结果不一致。接口名字相同不足以证明可替换,还须核对成员等价、允许操作与状态规则。此为按已读代码推导的边界,示例未执行。

子类替换要保持成员等价契约保存独立卡片。

原书依据 · 1 处

9.7.2 构造函数和方法链

NonNullSet先检查输入,再在当前对象上调用父初始化或父add,复用存储实现。类工厂用闭包保存父构造与过滤器,但覆写的方法还需要保留原返回契约。

链式使用依赖明确的返回契约关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处
初始化委派与方法继承分开

NonNullSet用Set.apply(this,arguments)让普通父构造在当前新对象上初始化,用原型链继承方法;二者职责不同,只有设置原型不会自动初始化父状态。覆写add先检查null和undefined,再调用Set.prototype.add处理真实写入,避免复制整套成员表逻辑。父构造若内部调用this.add,还可能进入子类覆写版本,因此初始化也需考虑动态分派路径。

初始化委派与方法继承分开保存独立卡片。

原书依据 · 1 处
类工厂用闭包保存协作参数

filteredSetSubclass把父构造和过滤器作为参数保存,建立子原型,并让生成的构造与覆写add都引用它们。改变父选择或过滤策略时无需到多个函数中重复替换硬编码名字。过滤器先验证整批参数,再委派父写入,但不自动使父实现或过滤器的副作用具有事务原子性;返回的新构造还应保持原接口的结果和错误契约。

类工厂用闭包保存协作参数保存独立卡片。

原书依据 · 1 处

9.7.3 组合vs子类

FilteredSet把过滤策略和底层集合保存为实例成员,修改入口先验证再委派,其余核心操作转交底层对象。它仍借用Set继承辅助方法,说明组合与继承可以共用,而非互相排斥。

组合优于继承的伸缩性优势

当过滤规则和底层集合实现可独立变化时,包装对象可持有具体集合与过滤函数,把验证放在新增入口,把存储操作委派给被包装对象,避免每种搭配都另建子类。本例FilteredSet仍继承Set的辅助方法,同时用组合复用实际存储。取舍应看变化维度和接口契约;外部若仍直接持有底层集合就可绕过过滤,包装也不自动重新验证已有成员。

结构图:展示本例原型与包装引用,构造函数节点不是类型,包装目标为实现示意;菱形为保存引用的聚合,虚线为创建或调用依赖。

classDiagram
  class FilteredCtor["FilteredSet(构造函数,非类型)"] {
    +FilteredSet(set, filter)
  }
  class FilteredObject["FilteredSet实例实现(示意)"] {
    set
    filter
  }
  class FilteredProto["FilteredSet.prototype(原型对象)"] {
    +add() Object
    +remove() Object
    +contains(v) Boolean
    +size() Number
    +foreach(f, c) undefined
  }
  class SetProto["Set.prototype(父原型对象)"] {
    +toString() String
    +equals(that) Boolean
  }
  class WrappedSet["set参数的集合实现(示意)"] {
    +add() Object
    +remove() Object
    +contains(v) Boolean
    +size() Number
    +foreach(f, c) undefined
  }
  FilteredCtor ..> FilteredObject : 初始化包装引用
  FilteredObject --> FilteredProto : 原型引用
  FilteredProto --> SetProto : 原型引用
  FilteredObject o-- WrappedSet : set 引用
  FilteredProto ..> WrappedSet : 委派核心操作

组合优于继承的伸缩性优势保存独立卡片。

原书依据 · 1 处

9.7.4 类的层次结构和抽象类

从具体存储抽出成员查询、有限枚举和可写修改三层契约,能让不同实现作为兄弟类复用辅助行为。完整例子已读;混入的批量操作仍依赖具体遍历是否允许边遍历边删除。

抽象接口由具体实现补齐关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处
集合接口按查询枚举和修改分层

AbstractSet要求contains;AbstractEnumerableSet再要求size与foreach,并实现文本、数组与等价辅助操作;AbstractWritableSet再要求add、remove并据此实现批量集合运算。SingletonSet、ArraySet等不同存储可选择适合的层次,而不必伪装成某个具体存储的专用版本。抽象构造与方法在本例显式抛错,具体子类提供所需实现,这些限制来自代码约定而不是单靠类名。

结构图:此类图展示原文各prototype对象上的接口层次,箭头表示原型引用;返回类型是接口预期,抽象占位函数本身抛异常。

classDiagram
  class AbstractSetProto["AbstractSet.prototype"] {
    +contains(x) Boolean
  }
  class EnumerableProto["AbstractEnumerableSet.prototype"] {
    +size() Number
    +foreach(f, c) undefined
    +isEmpty() Boolean
    +toArray() Array
    +equals(that) Boolean
  }
  class WritableProto["AbstractWritableSet.prototype"] {
    +add() Object
    +remove() Object
    +union(that) Object
    +intersection(that) Object
    +difference(that) Object
  }
  class SingletonProto["SingletonSet.prototype"] {
    +contains(x) Boolean
    +size() Number
    +foreach(f, ctx) undefined
  }
  class ArraySetProto["ArraySet.prototype"] {
    +contains(v) Boolean
    +size() Number
    +foreach(f, c) undefined
    +add() Object
    +remove() Object
  }
  class NotSetProto["NotSet.prototype"] {
    +contains(x) Boolean
    +toString(x) String
    +equals(that) Boolean
  }
  EnumerableProto --> AbstractSetProto : 原型引用
  WritableProto --> EnumerableProto : 原型引用
  SingletonProto --> EnumerableProto : 原型引用
  ArraySetProto --> WritableProto : 原型引用
  NotSetProto --> AbstractSetProto : 原型引用

集合接口按查询枚举和修改分层保存独立卡片。

原书依据 · 2 处
补集成员判断依赖约定全集

NotSet用底层集合contains结果的逻辑非表示补集成员判断。补集的含义离不开约定的候选全集;本例只提供逐项查询,没有提供全集枚举或有限大小,因此不能直接当作可枚举集合实现。底层集合后来改变时,相应补集判断也会改变,接口只读不代表被引用状态永远不变。

补集成员判断依赖约定全集保存独立卡片。

原书依据 · 1 处
数组集合以线性搜索换取简单存储

ArraySet用values数组存成员,contains依次搜索,添加前查重、删除时查位置后splice移除。该表示简单,适合规模较小时评估使用,但一次成员查询随成员数线性增长,批量操作会累加这种成本。它使用indexOf的严格相等规则,NaN无法匹配自身,故不自动满足对任意Number值的集合唯一约束;不能把本例直接等同于现代内置Set。

数组集合以线性搜索换取简单存储保存独立卡片。

原书依据 · 1 处
批量集合修改依赖遍历稳定性

AbstractWritableSet.intersection一边foreach当前集合,一边remove不属于目标的成员;ArraySet.foreach实际使用数组forEach,而remove用splice前移位置,可能跳过随后成员。按代码推导,[1,2,3]与仅含3的集合求交时,删除1后2可能被漏查,留下[2,3]。difference在参数与自身共享遍历存储时也要核对同类问题。复用抽象算法必须把遍历期间修改的契约算进去,不能只确认方法名字齐备。

批量集合修改依赖遍历稳定性保存独立卡片。

原书依据 · 1 处

9.8 ECMAScript 5中的类

ES5的描述符和可扩展性控制可用于细化实例与原型权限,使封装意图更明确。下节将分别处理枚举可见性、不可变数据和允许修改但维护约束的状态。

9.8.1 让属性不可枚举

不可枚举身份属性可避免普通枚举受到污染,但可见性与唯一身份不是一回事。此处的惰性getter会写对象,in检查继承编号还可能让父子对象共用同一编号。

给对象写身份号会产生额外约束关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处
不可枚举不保证独立身份

示例在Object.prototype定义只读getter,并在首次读取时给接收对象写不可枚举、不可写且不可配置的内部编号。不可枚举减少for/in污染,但idprop in this也会接受继承编号:对象把另一个已编号对象作为原型时,可能直接复用其编号。身份要求应区分自有与继承成员;不可扩展对象首次读取还会失败,不能把这个getter当成无副作用的通用唯一标识。

不可枚举不保证独立身份保存独立卡片。

原书依据 · 2 处

9.8.2 定义不可变的类

只读、不可配置端点可以固定自有绑定,原型方法也可限制覆盖,但这不等于对象深度不可变或永远无法扩展。封装描述符的工具函数同样只实现代码实际覆盖的属性种类。

定义属性缺省取决于是否已存在关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处
锁定端点不等于深度不可变

Range用不可写且不可配置的from/to固定端点引用,原型方法也可按同样权限定义。对象仍可能增加其他属性,端点引用若指向可变Date等对象,其内部状态仍可改变;构造函数的prototype属性也不因此自动锁定。所以应说明究竟固定了哪些绑定,而不是把本例称作对一切修改的全面禁止。

锁定端点不等于深度不可变保存独立卡片。

原书依据 · 1 处
原型检测不等于识别构造调用

本例Range在this满足既定原型关系时给当前对象定义端点,否则用Object.create创建并返回新对象,使常见new与普通调用两种入口都可使用。但this instanceof Range检查的是原型关系,不直接观察是否写了new;借用调用或其他构造路径也可能满足它。这个技巧需按入口契约解释,不能当作通用的构造调用检测器。

原型检测不等于识别构造调用保存独立卡片。

原书依据 · 1 处
属性工具函数需限定描述符种类

freezeProps在本例把选定可配置属性设为不可写、不可配置,hideProps只改变可枚举性。前者跳过所有不可配置属性,故仍可能留下本可收紧的可写属性;对可配置存取器写writable还可能转换属性种类,不能当作通用深冻结。hideProps省略configurable时保持旧值,并不会自动把它设成可配置。工具名与注释不能替代实际描述符操作。

属性工具函数需限定描述符种类保存独立卡片。

原书依据 · 2 处

9.8.3 封装对象状态

此Range允许端点变化,却把写入集中到不可配置的存取器里,通过比较维持起点不大于终点。封装限制入口,不能代替初值有效性或可变端点对象的生命周期约束。

闭包访问函数属于各个实例关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处
可变状态可通过入口维护不变量

Range把from、to留在构造调用的局部绑定中,getter读取,setter在新起点不大于终点或新终点不小于起点时才更新。实例存取器不可配置,因而不能像215的可写读取函数那样直接替换。它是在允许变化时维护关系约束,而不是让状态不可变;初始if(from>to)仍不能排除NaN等非法比较值,端点为可变对象时也需防范入口之外的状态变化。

结构图:此图描述写入判断,不是类型继承。

flowchart TD
  A[接收新的端点] --> B{修改起点还是终点}
  B -->|起点| C{新起点不大于当前终点}
  B -->|终点| D{新终点不小于当前起点}
  C -->|是| E[更新对应局部绑定]
  D -->|是| E
  C -->|否| F[抛出异常]
  D -->|否| F

可变状态可通过入口维护不变量保存独立卡片。

原书依据 · 1 处

9.8.4 防止类的扩展

封闭或冻结原型可限制扩展和普通覆盖,但属性权限与继承查找仍要分开。枚举公开入口和列表可冻结,列表中引用的枚举对象却不会随之自动深冻结。

方法包装需传递接收者参数结果关联本项背景,实质主要讲解在对应位置。

常量命名不冻结被引用对象关联本项背景,实质主要讲解在对应位置。

不可枚举不保证独立身份关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处
继承只读与显式定义自有属性不同

对象继承不可写的数据属性时,对同名属性的普通赋值会失败,严格模式还可报错;但在可扩展对象上显式定义自有属性,可能按自有属性定义规则建立遮蔽值。锁定原型方法因而会影响常规覆写方式,却不意味着所有子对象都不能拥有同名属性。需要区分赋值路径、定义路径和各自的对象权限。

继承只读与显式定义自有属性不同保存独立卡片。

原书依据 · 1 处

9.8.5 子类和ECMAScript 5

StringSet以无原型对象存字符串键,使in检查不受原型链干扰,再继承可写集合的通用算法。名称并未自动执行字符串校验,描述符缺省权限也会影响后续覆写。

定义属性缺省取决于是否已存在关联本项背景,实质主要讲解在对应位置。

集合接口按查询枚举和修改分层关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处
无原型字典仍需明确键的值域

StringSet用Object.create(null)保存键,没有继承成员,因而in可以直接判断这张字典中是否存在该键,Object.keys可取得其自有可枚举字符串名字。示例并未验证输入都是字符串,属性键转换会使数值1与字符串”1”落到同一项;若要保持任意原值身份,不能直接使用这套字符串键策略。无原型解决名字继承冲突,不会替代输入和值域契约。

无原型字典仍需明确键的值域保存独立卡片。

原书依据 · 1 处

9.8.6 属性描述符

Properties把目标对象和选定名字集合保存为可操作视图,提供隐藏、权限收紧、描述符复制和调试输出。它不是原对象副本,实际实现的方法也不同于开头注释所列的show。

属性工具函数需限定描述符种类关联本项背景,实质主要讲解在对应位置。

动态字典需明确成员边界关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处
属性视图保存目标与名字集合

properties()取得全部自有属性名或调用者给出的名字,再返回Properties视图。该视图保留目标o与names,hide和freeze会修改原目标,descriptors生成选定属性的描述映射,toString生成调试文本。因此它不是复制出的数据对象,名字列表也不自动持续反映后来新增属性;直接传入名字数组还会共享那份数组。

结构图:方法入口位于Object.prototype,Properties是构造函数而非类型;实现实例为示意。虚线为创建依赖,实线为原型引用。

classDiagram
  class ObjectProto["Object.prototype"] {
    +properties() Object
  }
  class PropertiesCtor["Properties(构造函数,非类型)"] {
    +Properties(o, names)
  }
  class PropertiesObject["Properties实例实现(示意)"] {
    o
    names
  }
  class PropertiesProto["Properties.prototype"] {
    +hide() Object
    +freeze() Object
    +descriptors() Object
    +toString() String
  }
  ObjectProto ..> PropertiesCtor : properties 创建视图
  PropertiesCtor ..> PropertiesObject : 保存目标与名字
  PropertiesObject --> PropertiesProto : 原型引用

属性视图保存目标与名字集合保存独立卡片。

原书依据 · 1 处
描述符报告需区分属性种类

Properties.toString把!desc.writable用于所有属性,但存取器描述符本来没有writable,因而带setter的存取器也会被显示成readonly。判断还只看get或set是否为真,会漏掉两者都为undefined的存取器形态。调试输出是实现提供的解释,不是规范本身;显示只读或accessor前应先区分数据与存取器描述,再按相应能力判断。

描述符报告需区分属性种类保存独立卡片。

原书依据 · 1 处

9.9 模块

模块化按职责组织可复用代码,并管理与其他代码的边界。本书使用对象和函数约定以减少全局名字;语言没有模块语法的描述属于当时背景,不代表现代JavaScript。

模块边界不仅由文件数量决定

模块可围绕一个类、一组相关类或函数库形成有边界的可复用单元;拆成文件只是组织方式之一。它应尽量减少无意的全局名字和共享环境修改,让别的模块能按约定协作。即使只导出一个全局对象,其公开属性、加载次序和共享状态仍需明确,不能用“只有一个变量”证明模块完全隔离。

模块边界不仅由文件数量决定保存独立卡片。

原书依据 · 2 处

模块系统管理加载与依赖

本书用Dojo、Google Closure库的模块入口以及CommonJS规范说明:模块系统可约定声明、加载和依赖管理,代码作者应配合所用系统导出API。这里是本书时代的简述,不是这些工具当前版本的用法指南,也不把不同系统的provide、require或exports接口当作完全相同。具体加载规则超出本节展开范围。

模块系统管理加载与依赖保存独立卡片。

原书依据 · 2 处

9.9.1 用做命名空间的对象

命名空间对象把相关公用成员归在一个入口下,降低顶层名字数量。调用方可建立局部别名以改善使用,但嵌套路径与文件布局仍是约定,不保证没有冲突或覆盖。

公开命名空间不等于私有模块

把集合类型放在sets或collections.sets等对象属性下,可减少顶层绑定并表达组织关系;调用方可给常用入口建立别名。命名空间属性仍可公开读写,不等于私有模块;反转域名只是降低命名碰撞的约定,不保证全局唯一或不会被其他代码修改。初始化也应避免无意重置已有子空间。

公开命名空间不等于私有模块保存独立卡片。

原书依据 · 1 处

9.9.2 作为私有命名空间的函数

模块函数把辅助实现留在局部作用域,再通过返回值、创建对象或既有命名空间明确导出API。闭包保留导出代码所需绑定,导出路径不同却不自动建立加载管理或安全沙箱。

IIFE是块级作用域缺失时代的隔离手段关联本项背景,实质主要讲解在对应位置。

模块边界不仅由文件数量决定关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处
私有模块通过明确出口暴露能力

模块函数可把v2s、objectId与计数等辅助绑定留在局部环境,只导出需要的构造或函数。单一API可直接返回,多个API可返回命名空间对象,也可按约定写入已有导出对象;构造形式则用this承载出口。应明确每条路径暴露的是什么,而不是假定执行了IIFE就自然对外可用或已完成依赖加载。

私有模块通过明确出口暴露能力保存独立卡片。

原书依据 · 2 处

第10章 正则表达式的模式匹配

正则表达式描述文本模式,RegExp与String分别提供执行搜索、提取和替换的接口。与其他语言正则的相似不代表语法和匹配行为完全一致,本章按JavaScript及其时代范围展开。

正则对象表达文本匹配规则关联本项背景,主要讲解保留在第3章对应位置。

原书依据 · 2 处

10.1 正则表达式的定义

字面量和RegExp构造器都能建立模式对象,模式字符与元字符应区分。对象身份还依版本规则,本书用ES3与ES5对比说明字面量每次求值是否复用对象。

正则字面量求值具有对象身份

/s$/与new RegExp(“s$”)都可表达此处的末尾s模式;ES5字面量每次求值建立新RegExp对象,不能把相同模式文本当成同一个对象引用。若把对象保存在变量中反复使用,则仍复用那个对象,其状态由相应方法处理。构造器用字符串表达模式还需经过字符串转义,模式文本相似不意味着两种源码写法可逐字互换。

正则字面量求值具有对象身份保存独立卡片。

原书依据 · 2 处

10.1.1 直接量字符

表10-1已完整查看。转义可以表达控制字符、十六进制字符或保留元字符的字面义,但一个反斜线并不对所有后继字符都表示同一种规则。

正则转义取决于语法位置

反斜线可把部分元字符按字面匹配,也可与字母构成特殊转义,如\n表示换行、\x0A或\u000A表示对应代码单元,匹配反斜线本身需写相应转义。正则字面量的斜杠还承担边界作用,构造字符串则另有字符串层转义。不能无条件采用“所有标点前都加反斜线”的经验,尤其需按目标版本、字符类内外和Unicode模式检查合法性。

正则转义取决于语法位置保存独立卡片。

原书依据 · 1 处

10.1.2 字符类

字符类每次选择一个符合范围的字符位置,否定类排除给定集合。表10-2已读,ASCII字母数字与下划线的word类、数字类及Unicode空白类不能混称所有文字或所有数字。

字符类按单个位置选择范围

[abc]匹配三个候选中的一个,[^abc]匹配候选之外一个位置,[a-z]表示相应码值范围,而不是把整组文本作为一个单元。ES5语境的\d是ASCII 0—9,\w包含ASCII字母、数字和下划线;原表把下划线漏掉,\W是这整组的补集。\s覆盖语言规定的空白与行终止符,不等于所有看起来留白的字符;字符类中的\b表示退格,不是单词边界。

字符类按单个位置选择范围保存独立卡片。

原书依据 · 1 处

10.1.3 重复

数量词约束前项或分组的重复次数,允许零次会使模式在看似没有目标字符的地方匹配空串。贪婪与非贪婪改变同一位置下的尝试偏好,却不把搜索改成全局最短结果。

数量词约束前项并允许空匹配

+为一次或多次,*允许零次,?表示零或一次,{n,m}规定闭区间次数,可作用于字符类或已分组单元。a*可在bbbb起点匹配空串,因此匹配成功不一定意味着消耗字符。原书\w{3}\d?是三个word字符加可选数字,不是三个单词;[^(]*允许零个非左括号字符,不是至少一个。表10-3的{n,m}上界应为m而非注释误写的n。

数量词约束前项并允许空匹配保存独立卡片。

原书依据 · 1 处
非贪婪仍优先最早成功位置

数量词后加?使其优先尝试较少重复,但仍需让整个表达式成功。a+?b匹配aaab时,最早起点需要逐渐扩展到三个a才能接到b,所以仍匹配整个aaab;它不会为了更短结果先跳到最后一个a。非贪婪不是全局寻找最短子串,贪婪也不是不管后续条件地吞掉全部输入。

非贪婪仍优先最早成功位置保存独立卡片。

原书依据 · 2 处

10.1.4 选择、分组和引用

选择按分支顺序尝试,分组可控制重复范围、捕获结果或反向引用。捕获引用要求再次出现相同文本,不是重新执行那段子模式;非捕获分组则不占捕获编号。

选择分支顺序会影响成功结果

正则a|ab在字符串ab处可由左分支先成功得到a,不因右分支能匹配更长文本就自动改选它。若整个模式后续失败,仍可能按引擎规则回溯尝试其他分支,因此“忽略右边”须放在整体已经成功的条件下理解。组合模式时要确定希望优先接受什么,而不是把选择项仅看成无序集合。

选择分支顺序会影响成功结果保存独立卡片。

原书依据 · 1 处
分组控制范围与捕获编号

圆括号可把多个项作为重复或选择的整体,并保存成功匹配文本以便提取;捕获编号按捕获左括号的出现顺序确定,嵌套分组也会计数。(?:…)只负责组合而不建立编号,能避免结构分组改变后续数字引用。组的语法范围与最终保存的文本是两件事,不能只凭括号层数猜编号。

分组控制范围与捕获编号保存独立卡片。

原书依据 · 1 处
反向引用要求相同的已捕获文本

反向引用\1再次匹配第一个捕获组实际取得的文本,适合要求首尾引号一致,而不是再运行相同模式以接受另一段不同文字。原书引号例子仍排除了内容中的两种引号,不等于完整字符串转义解析器。字符类中的[^\1]也不表示“除去捕获文本中的字符”,不可把数字引用直接当作动态否定字符集合;语法合法性还取决于模式与版本。

反向引用要求相同的已捕获文本保存独立卡片。

原书依据 · 1 处

10.1.5 指定匹配位置

锚和断言在位置上施加条件而不消耗对应字符。word边界依赖word字符集合,不是完整自然语言分词;先行断言则要求后续模式能匹配或不能匹配。

位置断言不消耗对应字符

^与$约束开始或结束位置,\b检查word与非word位置的边界,\B表示非该边界;它们不把分隔空白包含到结果中。\bJava\b因而不同于显式消费两侧空白,但本书word规则基于\w,不能把它当作任意语言的完整分词边界。是否允许每行起止,还要看m标志。

位置断言不消耗对应字符保存独立卡片。

原书依据 · 1 处
先行断言检查后续而不取走文本

(?=p)要求当前位置之后可匹配p,(?!p)要求后续不能匹配p,两者不消费那段文本。模式Java(?!Script)([A-Z]\w*)可接受JavaBeans,却会拒绝JavaScript和JavaScripter,因为Java之后已有Script;原书说前者可匹配是错误结果。断言后其他项仍要成功,不能把负断言理解成后续字符“都不必检查”。

先行断言检查后续而不取走文本保存独立卡片。

原书依据 · 1 处

10.1.6 修饰符

i、g、m分别控制大小写、全局查找及多行起止,标志位于模式字面量结束斜杠后。g与方法如何配合影响结果,m不改变点号匹配行终止符的规则。

正则标志控制不同匹配维度

本书ES5范围的i用于忽略大小写,g用于相应接口中的全局匹配,m使^和$也可按行边界断言。它们可组合,如/\bjava\b/gi,但m不等于“任意字符包括换行”,g也不保证每个调用直接返回全部详细捕获结果。标志的具体效果需结合String或RegExp使用入口判断;本章三个标志不是所有现代版本标志的穷尽列表。

正则标志控制不同匹配维度保存独立卡片。

原书依据 · 4 处

10.2 用于模式匹配的String方法

String的正则接口分别回答起始位置、替换文本、捕获内容和切分片段。g在不同方法中改变的不是同一种返回结构,URL和引号例子也只是受限格式演示。

匹配操作返回不同结果关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

文本检索分位置与捕获结果

search返回首次起始索引,未找到为−1,并忽略正则g;match则提取内容,没有g时返回完整匹配、捕获组和位置等信息,有g时返回各次完整匹配的列表而不逐项保留同样的捕获明细。没有匹配时还需处理null。先明确需要位置、完整文本还是各组内容,再选接口,不能把所有“匹配数组”当成同一种形状。

文本检索分位置与捕获结果保存独立卡片。

原书依据 · 3 处

替换模板与模式引用语法不同

replace以字符串或正则指定要改的文本,带g的正则用于全局替换;字符串查找参数则按字面搜索。替换模板的$1引用第一捕获组,不同于正则模式里的\1;第二参数也可用函数按每次匹配计算替代文本。操作产生新字符串,不会把原字符串值原地改写。原书曲引号例子只是替换引号外形,不是完整的转义字符串解析。

替换模板与模式引用语法不同保存独立卡片。

原书依据 · 2 处

正则分隔可吸收周边空白

split把分隔规则两侧的文本放入片段数组;用/\s,\s/作分隔,可以把逗号及其紧邻空白一并消费,而不是之后再逐项手工去空白。它回答的是边界之间有什么,不同于match提取边界本身。原文简单逗号例子不能推广为含引号、转义和字段内逗号的完整CSV解析器,其他捕获与空匹配规则需按具体接口核对。

split省略分隔符通常返回含原文本的一项;空字符串分隔符按码元拆分,可能拆开代理对,不能把任意可空正则都视为等价。limit限制返回数组项数,不自动把未处理后缀留在最后一项;捕获组可作为额外结果,未参与的捕获还可能为undefined。

正则分隔可吸收周边空白保存独立卡片。

原书依据 · 2 处

10.3 RegExp对象

动态构造把字符串解析为模式,可另传本书范围的g/i/m标志。模式进入字符串源码时有双层转义,但动态数据并不必然都应被当成正则语法。

动态模式构造有双层转义边界

new RegExp(”\d{5}“,“g”)中的字符串层先把双反斜线变成一个,模式解析才见到\d{5};这与直接写/\d{5}/的源码层次不同。动态输入若代表模式,需要按模式语法处理;若只是要查找的普通文本,则不能不加区分地把元字符解释成规则。用户提供的是被搜索文本时,也不因此必须动态创建模式,原书这句话把角色混淆了。

核心参考的“正则输入时不能传flags”是旧版限制;现行构造可以显式提供新flags。无new且传入正则时是否原样返回还受flags缺省和constructor等条件约束;不能把模式文本相同当身份相同。

正则source不包含外层斜杠或flags,toString通常组合为/模式/标志;二者不保存lastIndex。source是适合表示模式的转义形式,不保证逐字还原最初源码拼写,也不替代构造时的字符串层转义。

动态模式构造有双层转义边界保存独立卡片。

原书依据 · 4 处

10.3.1 RegExp的属性

source及三个布尔标志描述本书范围的模式配置,lastIndex则是可写的搜索状态。配置与状态不能混成相同的只读属性集合,也不能以“五个”当现代完整字段清单。

全局匹配状态属于正则对象

同一带g的RegExp对象可通过lastIndex保存下一次exec或test的搜索起点,状态属于对象而不是某个字符串。成功匹配会更新到结束位置,失败会重置,因此重用于新字符串前应明确从哪里开始。它是可写状态,使用时按规则转换为起点,不因赋值就自动验证为有效整数;source、global、ignoreCase、multiline在本书版本中则用于描述模式配置。

全局匹配状态属于正则对象保存独立卡片。

原书依据 · 4 处

10.3.2 RegExp的方法

exec每次给出一个详细匹配或null,test只给是否匹配,但带g时两者都受lastIndex影响。原书把String方法一概说成重置lastIndex、以及结尾失败还需手动重置,都应按接口分别纠正。

全局匹配状态属于正则对象关联本项背景,实质主要讲解在对应位置。

非贪婪仍优先最早成功位置关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处
执行匹配需区分明细与布尔结果

exec(text)成功时返回单次完整文本、捕获组、index与input,失败返回null,即使有g也不会一次变成全部匹配列表。test(text)只回答是否有匹配,但对带g的同一对象也会推进搜索状态,重复测试未必得到相同结果。只需要独立存在判断时,应明确是否需要状态和是否重置;不能因返回布尔值就假定操作没有副作用。

执行匹配需区分明细与布尔结果保存独立卡片。

原书依据 · 3 处
空匹配循环须保证搜索前进

由前文允许零长度的模式与本节结束位置规则可推得:exec成功不保证起点向前移动,空匹配可使下一次再次命中同一位置。只以结果非null反复执行同一全局对象,可能停在同一空结果。循环应明确结束条件及空匹配时如何按目标版本的字符单位推进,不能把普通Java示例的进展性推广到任意模式。

结构图:图示为需要明确的控制责任,非原书现成实现或实测结果。

flowchart TD
  A[从当前搜索状态执行exec] --> B{是否匹配成功}
  B -->|否| C[结束循环]
  B -->|是| D[处理本次匹配]
  D --> E{本次是否空匹配}
  E -->|是| F[按目标规则推进起点]
  F --> A
  E -->|否| A

空匹配循环须保证搜索前进保存独立卡片。

原书依据 · 2 处

第11章 JavaScript的子集和扩展

本章介绍的子集是对可用能力作限制,扩展则是特定实现提供的额外语法或行为。Mozilla JavaScript 1.x与ECMAScript版次不是同一编号体系,不能把本章旧扩展全部当作现代标准。

语言标准不同于引擎版本关联本项背景,主要讲解保留在第1章对应位置。

原书依据 · 2 处

11.1 JavaScript的子集

本节先说明有些子集用于风格一致和简化编程,另一些用于限制不可信代码能力。两种目的不同,不能把风格约束自动当作安全证明。

11.1.1 精华

The Good Parts通过主动避开部分语言构造和统一风格减少歧义,JSLint把其中一些约定变成可检查规则。本书的var、严格模式和选项状态都应放回当时版本。

精华子集主动避开语言怪癖

Crockford的The Good Parts选择较小语言用法以减少怪癖和不一致,例如避开with、eval及宽松相等,并统一花括号、分号和函数组织。它回答团队愿意采用什么风格,不代表被排除的每种语法都在语言中非法,也不直接提供运行不可信代码的隔离保证。var集中到函数顶部等约定还与本书时代的作用域模型相关,不能未经判断照搬到现代所有声明。

精华子集主动避开语言怪癖保存独立卡片。

原书依据 · 1 处
JSLint把部分约定变为检查

本书介绍JSLint作为代码质量检查工具,可约束部分语言用法、缩进和风格一致性,把约定变成可重复检查。具体规则和选项反映本书当时工具,不是当前安装或配置指南。检查通过说明符合那些规则,不证明业务结果正确、程序没有运行时错误或已成为安全沙箱;应先明确检查器实际承担的责任。

JSLint把部分约定变为检查保存独立卡片。

原书依据 · 1 处

11.1.2 子集的安全性

安全子集结合受限语法、静态检查、代码转换、运行期守卫及受控环境API,意图限制不可信代码所能触达的能力。项目例子是历史方案,不能从禁用几个名字或改名规则推出完整安全性。

安全子集用静态分析加运行时兜底隔离不可信代码

本书讨论的历史沙箱先限定允许语法和可触达API,再以静态检查拒绝或转换危险路径;无法一般静态确定的动态属性访问,可改写成运行时守卫调用。DOM等全局能力则通过受限API或代理界面提供,避免直接交出整个页面控制权。具体方案对eval、this、with和属性名的限制各不相同,不是所有安全系统都必须禁掉相同词语。分层策略还依赖完整的能力边界、转换正确性和宿主规则,不能仅凭黑名单或风格检查声称任意第三方代码安全。

结构图:本图概括本书所列方案的可选处理路径,不是可直接部署的完整沙箱实现。

flowchart TD
  A[不可信代码] --> B[受限语法与能力检查]
  B --> C{满足静态规则}
  C -->|否| D[拒绝或按规则转换]
  D --> E[受限代码与运行时守卫]
  C -->|是| E
  E --> F[经受控API访问获准资源]

安全子集用静态分析加运行时兜底隔离不可信代码保存独立卡片。

原书依据 · 1 处
ADsafe以静态子集限制能力

原书中的ADsafe采用严格JavaScript子集,以JSLint式检查限制语言和全局访问,再通过ADSAFE入口提供允许的API及受限DOM操作。它展示静态限制与能力接口结合的早期方案;这段历史介绍不是当前部署建议,也不能单凭项目名保证所有网页代码都能被安全容纳。

ADsafe以静态子集限制能力保存独立卡片。

原书依据 · 1 处
Dojo安全扩展约束脚本能力

本书的dojox.secure把安全子集作为Dojo扩展,用JavaScript实现检查器,在执行第三方代码前检查其是否处于受限范围,并结合受控DOM用法。它与完全禁用DOM的方案在开放能力上不同;执行前动态运行检查器,也不等于每个危险操作都已有执行期守卫。这里保留历史设计职责,不作为现代Dojo接口指南。

Dojo安全扩展约束脚本能力保存独立卡片。

原书依据 · 1 处
Caja转换页面为隔离模块

本书的Caja包含Cajita与Valija等不同宽度的受限语言,并用编译转换处理HTML、CSS和JavaScript,意图让模块在共享页面中隔离协作。它把更易用的输入范围与较小受控执行范围连接起来,安全仍依赖转换器和运行环境的实际边界。OpenSocial与门户使用叙述只属当时背景,不据此判断今天项目状态或可部署性。

Caja转换页面为隔离模块保存独立卡片。

原书依据 · 1 处
FBJS重写名字与访问路径

原书中的FBJS通过转换顶层标识符、约束this与DOM访问并加入运行时检查,意图隔离个人资料页中的第三方模块。前缀改名可减少名字碰撞,但不能孤立地保证所有全局访问或动态代码路径已被封死;其余能力限制同样重要。这是历史系统设计的介绍,不能把Facebook当前功能或安全策略推断为仍采用同样实现。

FBJS重写名字与访问路径保存独立卡片。

原书依据 · 1 处
网页沙箱以重写约束运行

本书把Microsoft Web Sandbox描述为对JavaScript以及HTML、CSS作较强重写的隔离方案,用受控运行机制处理不可信页面内容。它代表扩大输入便利性、再以更复杂转换约束执行的方向;原书并未在此展开完整实现或证明,不能据“类似虚拟机”就保证任意内容安全。未核验当前维护状态,也未选择它作部署实践。

网页沙箱以重写约束运行保存独立卡片。

原书依据 · 1 处

11.2 常量和局部变量

本节讲的是旧Mozilla const、let声明、let块和let表达式,并非现代标准用法的完整说明。块作用域本身值得保留,但初始化前访问及重赋值结果必须明确区分版本。

块绑定缩小变量可见范围

let绑定让循环变量或临时变量局限在相应词法块中,而不是让所有var声明都占据整个函数范围。本书oddsums用循环内的x和odd表达这种限制,循环外不应直接取得它们。但把var批量改成let仍可能改变初始化、遮蔽与闭包行为,不能只因作用域更小就视作完全等价的机械替换。

块绑定缩小变量可见范围保存独立卡片。

原书依据 · 1 处

词法绑定初始化前不可读取

原书旧Mozilla扩展把某些let初始化前读取描述为undefined,并把for初始化表达式放在新变量作用域之外。现代标准let与const在词法绑定初始化前不能读取;同名let x=x+1会遇到未初始化绑定,而非可靠取得外层x或算出NaN。因此旧例子的输出必须保留实现版本标签,不能作为当前标准运行结果;变量建立与完成初始化是不同阶段。

词法绑定初始化前不可读取保存独立卡片。

原书依据 · 1 处

旧常量扩展不同于标准常量

原书Mozilla扩展的const示例把重赋值视为静默忽略,并按旧模型谈声明提前。现代标准const约束的是绑定重赋值,重新赋值会报错,且同样具有初始化前访问限制;它不使引用对象自动深度不可变。阅读历史常量语法时应分清绑定、所指对象与版本规则,不能把旧pi示例直接视为现行行为。

旧常量扩展不同于标准常量保存独立卡片。

原书依据 · 1 处

旧let块表达式是独立扩展形式

本书的let(x=…,y=…){…}与let(x=…,y=…)表达式,把一组局部绑定与块或结果表达式组合;其初始化按所述旧扩展环境求值。这两种专门形式不同于现代标准let声明语句。旧script版本参数或version()也是实现选择入口,不是今天所有浏览器启用标准let的通用方法;不应照书附加旧版本标记来修复现代代码。

旧let块表达式是独立扩展形式保存独立卡片。

原书依据 · 1 处

11.3 解构赋值

解构用模式从结构化值中提取位置或属性,把返回多值、交换和局部重命名写得更直接。模式语法与对象字面量相似却职责不同,旧扩展对剩余元素的限制也不是现代标准结论。

解构按模式把结构映射到目标

数组式解构按位置提取,空位可跳过相应位置,未取到的值通常得到undefined,多出的值在本书所示模式中被忽略。交换写法先求右侧结构再把值给各目标,不是先覆盖一个变量再拿被覆盖值赋另一个。整个赋值表达式仍以右侧值为结果,所以链式解构不只返回某个被取出的成员;目标赋值本身也可能有顺序与副作用。

解构按模式把结构映射到目标保存独立卡片。

原书依据 · 1 处

对象解构的键与目标名分开

对象模式{r:red}中r是要查找的属性名,red是接收值的变量名;它不表示创建名为r的新局部变量。嵌套模式沿相应结构继续提取,可以组合对象和数组形式,但也更容易混淆路径与目标。取出对象成员通常仍保存原引用,不因解构而深复制整棵结构;缺少中间结构也不能简单视作所有深层目标都安全变成undefined。

对象解构的键与目标名分开保存独立卡片。

原书依据 · 1 处

解构剩余元素需区分版本

本书旧扩展说不能把剩余数组成员收集到一个目标中,不能作为现代标准限制。现代数组解构可用…rest收集其余迭代值;这与单个目标自动吞下全部剩余值不同,必须显式写出模式。原书嵌套例子的let(…){…}还依赖旧let块语法,应把解构概念与那种历史声明形式分开。

解构剩余元素需区分版本保存独立卡片。

原书依据 · 1 处

11.4 迭代

本节引导到旧Mozilla迭代扩展,分别介绍值枚举、迭代器状态、可恢复生成器与推导表达式。这些都需与现代标准协议区分。

11.4.1 for/each循环

旧for each枚举的是可枚举属性值,不是键,但仍可能包含继承成员。它与现代for…of的迭代协议不同,也不能仅因值看起来像数组元素便推断顺序契约。

旧值枚举仍受属性集合限制

本书for each(let v in o)属于旧Mozilla/E4X扩展,取可枚举属性值;普通for/in取名字。对数组使用时,它仍可能带出继承成员或普通命名属性的值,不保证只得到按索引排列的自有元素。这不是现代标准for…of的同义写法,迁移时要先决定要枚举属性,还是要消费对象提供的迭代序列。

旧值枚举仍受属性集合限制保存独立卡片。

原书依据 · 1 处

11.4.2 迭代器

迭代器保存一次遍历位置,可迭代对象提供取得迭代器的入口。旧协议用iterator、直接值和StopIteration协作,现代标准使用不同入口及结果对象,不能互换。

迭代器与可迭代对象职责分开

迭代器封装一次遍历状态,每次next推进;可迭代对象则提供创建或取得迭代器的入口。本书range把边界保留在外层,iterator每次调用建立自己的val状态,返回有限整数迭代器。旧协议以StopIteration对象表示结束,现代标准通常由Symbol.iterator取得迭代器,next返回含value和done含义的对象;旧for/in扩展不是现代普通属性枚举的保证。

结构图:仅表示本书旧协议;range是工厂函数而非类型,其余为未单独命名的实现示意。虚线为创建依赖。

classDiagram
  class RangeFactory["range(工厂函数,非类型)"] {
    +range(min, max) Object
  }
  class RangeIterable["范围可迭代对象实现(示意)"] {
    min
    max
    +includes(x) Boolean
    +toString() String
    +__iterator__() Object
  }
  class RangeIterator["范围迭代器实现(示意)"] {
    +next() Number
  }
  RangeFactory ..> RangeIterable : 建立范围边界
  RangeIterable ..> RangeIterator : 每次建立遍历状态

迭代器与可迭代对象职责分开保存独立卡片。

原书依据 · 1 处
旧迭代适配器选择键值范围

本书旧Mozilla的Iterator(o)可为普通对象产生自有属性的键值对,第二参数true则只产生名字,因此可与解构配合进行受限属性遍历。它也可委派对象的iterator入口。这个历史全局函数不能与现代同名Iterator或Symbol.iterator协议直接混用;现代存在同名标识,也不意味着Iterator(o,true)具有旧式行为。

旧迭代适配器选择键值范围保存独立卡片。

原书依据 · 1 处

11.4.3 生成器

生成器对象保存可恢复执行状态,yield产出后挂起,消费方再次恢复才继续。旧协议的next、send、throw和close展示不同恢复方式;现代语法与终止结果不能照旧例直接解释。

生成器恢复到下一次产出位置

调用生成器函数得到一个可恢复的生成器对象,推进调用使函数从保存位置运行到下一次yield,再交出值并挂起。局部状态可跨多次推进保留,有限序列最终完成,无限序列需要消费方限制取值。本书用普通function含yield识别旧Mozilla生成器,现代标准function*和{value,done}结果协议不同;旧的带值return禁令也不能直接套用现代标准。

结构图:概念状态图,具体完成通知按版本协议判断。

stateDiagram-v2
  [*] --> 已建立
  已建立 --> 运行中 : 首次推进
  运行中 --> 已挂起 : yield产出
  已挂起 --> 运行中 : 再次恢复
  运行中 --> 已完成 : 正常结束
  已挂起 --> 已完成 : 按协议终止
  已完成 --> [*]

生成器恢复到下一次产出位置保存独立卡片。

原书依据 · 1 处
生成器实现惰性求值的处理管道

本书把按行提取、去空白、过滤空行注释组成生成器管道,由消费端请求时逐步产出,遇到quit即可停止继续处理后面的逻辑。中间步骤不用先各自建立完整结果数组,但eachline仍接收整个字符串,并不是已经实现文件流式读取或保证最小内存。是否关闭上游与何时释放其他引用,还需按具体迭代协议处理。例子采用旧Mozilla生成器语法,概念可迁移,代码不能直接视作现代标准。

结构图:实线表示逐项数据变换;消费需求驱动这些步骤按需执行。

flowchart LR
  A[整段文本] --> B[按需取一行]
  B --> C[去除首尾空白]
  C --> D[过滤空行与注释]
  D --> E[消费并判断quit]

生成器实现惰性求值的处理管道保存独立卡片。

原书依据 · 1 处
生成器产出与恢复输入不同

本书旧send(value)在恢复时把值送回暂停的yield表达式,throw(value)则在暂停点注入异常;next只请求继续,close按旧协议终止并运行相应finally。这些是产出方向之外的恢复控制,不应把yield单纯当return。counter示例用真假判断增量,所以传0会落入自增分支;异常reset也只是演示控制信号。现代方法与返回结果需另按标准,不直接照抄旧send/close。

生成器产出与恢复输入不同保存独立卡片。

原书依据 · 1 处

11.4.4 数组推导

数组推导按遍历、可选过滤和结果表达式建立新数组,书写顺序把结果表达式放在for前,执行顺序却仍取决于迭代与判断。本节语法属于旧Mozilla扩展。

数组推导按过滤后映射求值

本书[expression for(variable in object) if(condition)]先从序列取得一个值,判断可选条件,通过后再求expression并追加到结果数组。推导变量在其局部范围内,不应泄漏成全局绑定;旧等价展开例子若省略变量声明,就不再保持同样范围。它最终会建立数组,因此与逐项惰性生成结果的接口仍有差别;这种旧写法不能当作现行标准数组字面量。

数组推导按过滤后映射求值保存独立卡片。

原书依据 · 1 处

11.4.5 生成器表达式

生成器表达式以与推导相近的写法建立惰性序列,但结果不是可随机索引的数组。按需计算减少提前工作,也改变访问方式和是否可重复消费的预期。

惰性序列通常按顺序消费

本书生成器表达式把推导的方括号换为圆括号,得到逐次请求才求值的生成器,而不是一次建立完整数组。它适合不必预先计算全部结果的序列,包括潜在无穷输入;但没有数组索引,要取得后续第n项通常需先推进前面各项。惰性与随机访问是不同契约,也不自动保证结果可无限重复遍历;这套表达式语法是旧Mozilla扩展,不能作为现行标准写法。

惰性序列通常按顺序消费保存独立卡片。

原书依据 · 1 处

11.5 函数简写

表达式闭包是本书旧Mozilla简写,在function参数后直接放结果表达式,省掉花括号和return。它是当时普通函数写法的简化,不等于现代箭头函数的全部语义。

旧函数简写不等于箭头语义

本书function(x)x+1表示仅计算表达式并返回其值的旧表达式闭包,原意与相应普通函数体一致。这种历史语法不能直接当作现代标准,也不能仅凭同样简短就机械替成箭头函数并保证行为相同;箭头函数与普通函数在this等绑定上存在区别。排序或数组回调的可读性应以用途和接口为准,不是省掉多少符号。

旧函数简写不等于箭头语义保存独立卡片。

原书依据 · 1 处

11.6 多catch从句

旧多catch按从前到后的条件选择第一个处理分支,未命中则继续传播原异常。其价值是明确分派与兜底,但语法并不是现代标准的多catch结构。

异常分派需保留未处理错误

本书旧catch(e if condition)从前到后判断,首个为真的分支处理后跳过后续分支;无条件catch相当于兜底,若全未匹配则异常继续传播。现代标准不直接接受这套多catch语法,可在适用的单个catch中按契约区分并重新抛出未处理错误。不能为了方便分派而把所有异常都默默当成已恢复。finally的清理职责仍需与分派结果分开。

异常分派需保留未处理错误保存独立卡片。

原书依据 · 1 处

11.7 E4X:ECMAScript for XML

E4X用专门的XML对象、列表和语法处理结构数据,与浏览器DOM不是同一套对象。原书完整入门及脚注已读;ECMA-357当前官方归类已撤销,笔记保留历史机制而不建议当现行核心语法使用。

E4X扩展与DOM不是同一层

本书E4X把XML元素、属性和片段作为专门的XML或XMLList值,用额外语法创建、查询和修改;它不是把DOM节点换个名字,也不保证与浏览器DOM自动互转。E4X由独立ECMA-357定义,官方现将该标准列为Withdrawn。此卡解释历史扩展在本书中的角色,不把旧SpiderMonkey或Rhino支持情况当成现代浏览器能力。

E4X扩展与DOM不是同一层保存独立卡片。

原书依据 · 1 处

XML单项与片段使用不同入口

E4X可用XML字面量建立结构,并在花括号中嵌入JavaScript表达式;也可把字符串交给XML或XMLList分别表示单项结构与包含多个项的片段。取得XML节点与取得其字符串表示不同,不能仅看示例注释中的Hydrogen就把names[0]当普通字符串。示例数据与化学元素名称只用于展示结构操作,不承担XML之外的业务校验。

XML单项与片段使用不同入口保存独立卡片。

原书依据 · 1 处

XML子节点与后代查询分开

本书E4X中pt.element.name沿指定层次取匹配项,pt..name从后代中找同名节点,pt.element.*则取对应元素的子项。返回可能是XML列表,再按位置取成员;这不同于普通对象属性只有一个标量的直觉。先确定要固定路径、任意深度还是通配子项,再选择操作,不能把三个例子在所有结构上当完全等价。

XML子节点与后代查询分开保存独立卡片。

原书依据 · 1 处

XML属性与元素分开访问

E4X的@id选择属性,@*选择属性集合,与点路径取得子元素不同。pt.element[1].@id取第二个匹配元素的id,并不是按元素名称去找氮;原书该注释与其示例顺序不符。区分位置、元素名与属性名,才能正确理解查询返回的结构和值。for each在这里遍历选择得到的XML项,仍属于旧扩展协议。

XML属性与元素分开访问保存独立卡片。

原书依据 · 1 处

XML过滤增删直接作用于结构

E4X可对列表应用谓词过滤,再在结果上取子项;可用pt.element[0].@symbol=“H”设置属性、用weight属性式赋值添加子元素,并通过delete删除选定属性或节点。insertChildBefore还按指定位置插入结构。它们修改的是XML表示,不等于普通字符串替换;delete pt..weight针对weight,原文widget注释为误写。

XML过滤增删直接作用于结构保存独立卡片。

原书依据 · 1 处

命名空间用URI限定节点名字

同一本书E4X例子中,XHTML设为默认命名空间,而嵌入的SVG使用另一个URI;选择SVG rect时通过Namespace值和::限定名字。节点名还可分为uri与localName,因此只看显示标签相同并不足以判断其名字相同。命名空间用于避免词汇冲突,不是JavaScript对象命名空间的同一机制,也不意味着按该URI自动下载内容。

命名空间用URI限定节点名字保存独立卡片。

原书依据 · 1 处

第12章 服务器端JavaScript

JavaScript可嵌入浏览器之外的宿主,由宿主提供文件、进程、网络或Java平台能力。Rhino与Node在本章中展示不同嵌入路线,所谓服务端并不只指HTTP服务器。

宿主环境提供平台能力关联本项背景,主要讲解保留在第1章对应位置。

原书依据 · 2 处

12.1 用Rhino脚本化Java

Rhino用Java实现JavaScript执行,并通过桥接访问Java包、类、方法、字段、数组和接口。本文完整示例与类型转换说明已读;以下按原书1.7r2背景记录,不充作当前Rhino安装手册。

Rhino复用Java平台

Rhino在Java平台上执行JavaScript,并使脚本能访问Java类与对象,在桥接层按规则转换部分数据。它适合说明宿主嵌入如何复用现有平台能力,而不是要求用JavaScript重写Java库。本书以1.7r2及当时扩展为背景,版本成熟度、下载与ES5支持叙述都不代表今天状态;互操作仍有类型和方法分派边界。

Rhino复用Java平台保存独立卡片。

原书依据 · 1 处

Rhino输入加载属于宿主接口

本书Rhino的print输出、readFile/readUrl读取文本,load加载并执行脚本,均是宿主提供的全局能力,不是ECMAScript核心API。读取数据与执行文件责任不同,即使参数都是路径或URL也不能互换;实际可用函数和资源权限还依嵌入配置。通过help或相应环境文档核对版本,而非假定浏览器也提供这些入口。

Rhino输入加载属于宿主接口保存独立卡片。

原书依据 · 1 处

Rhino线程命令依赖宿主

spawn(f)在原书环境中启动线程执行函数或脚本,runCommand调用外部命令,quit退出解释器,version选择旧语言版本。这些改变执行环境或进程状态,不能仅因写成普通函数就当作纯计算。它们展示Rhino宿主入口的不同责任,并不保证所有嵌入应用都会开放相同能力;此处不执行线程、命令或退出操作。

Rhino线程命令依赖宿主保存独立卡片。

原书依据 · 1 处

Java包与类可映射为脚本入口

Rhino把Packages层次与部分java、javax短名映射为可访问对象,可用变量保存类引用,或通过importClass和importPackage引入名称。JavaImporter配合旧with也可建立一段查找范围,但名字冲突仍需处理,例如大范围导入java.lang会与脚本名字重叠。引入名称只改变访问便利性,不等于复制类实现或取得另一套独立Java类型。

Java包与类可映射为脚本入口保存独立卡片。

原书依据 · 1 处

宿主重载需要匹配真实签名

Rhino允许脚本调用Java构造和方法,并把某些getter/setter显示为属性,但Java重载仍依真实参数签名分派;必要时可用o‘f(int)’显式选择版本。能通过点或方括号访问不代表已变成普通JavaScript字段或任意动态参数函数。实例of也可反映Java继承与接口关系,具体桥接规则应按该环境核对。

宿主重载需要匹配真实签名保存独立卡片。

原书依据 · 1 处

宿主数组不等于脚本数组

本书用反射创建定长Java数组,再以索引从脚本读写;它们仍有固定元素类型与长度,不自动取得JavaScript数组的slice等方法。newInstance(java.lang.Byte.TYPE,128)表达的是128个字节位置,实际写入还要遵守Java字节值域与转换规则。形态像数组不等于存储与操作契约相同,跨语言边界应明确类型和容量。

宿主数组不等于脚本数组保存独立卡片。

原书依据 · 1 处

脚本实现可适配Java接口

Rhino可把带对应方法的脚本对象适配成Java接口实现;单方法接口也可使用函数,JavaAdapter还可组合多个接口。调用会跨越语言边界,方法名、参数和回调语境仍需符合Java契约,不是只因某属性可调用就保证完整实现。原书WindowAdapter与事件监听例子用于展示适配入口,未执行GUI。

结构图:真实Java接口与未命名脚本适配实现分开;虚线实现箭头表示由Rhino完成适配,不是JavaScript对象的原型继承。

classDiagram
  class FocusListener["java.awt.event.FocusListener"] {
    <<interface>>
    +focusGained(e) void
    +focusLost(e) void
  }
  class FocusImpl["焦点监听实现(示意)"] {
    +focusGained(e) void
    +focusLost(e) void
  }
  class ActionListener["java.awt.event.ActionListener"] {
    <<interface>>
    +actionPerformed(e) void
  }
  class Runnable["java.lang.Runnable"] {
    <<interface>>
    +run() void
  }
  class MultiImpl["JavaAdapter实现(示意)"] {
    +actionPerformed(e) void
    +run() void
  }
  FocusImpl ..|> FocusListener : Rhino适配实现
  MultiImpl ..|> ActionListener : Rhino适配实现
  MultiImpl ..|> Runnable : Rhino适配实现

脚本实现可适配Java接口保存独立卡片。

原书依据 · 1 处

跨语言异常保留原始故障对象

本书Rhino将Java方法异常映射为可被JavaScript catch捕获的错误,并可经javaException查看原Java异常。识别这层映射有助于区分脚本调用点与平台根因,而不是只看一条通用文本。访问原异常也需按实际桥接版本判断,不能认为所有JavaScript错误都天然带javaException或都能继续正常执行。

跨语言异常保留原始故障对象保存独立卡片。

原书依据 · 1 处

Java字符串与脚本字符串不同

Java方法在本书桥接设置下可返回java.lang.String对象,它的length()与脚本字符串length属性不同,typeof也可能为object。调用其toString仍可返回Java字符串,显式交给JavaScript的String(…)才表达转换为脚本字符串的意图。相似显示文本不证明运行时表示相同,处理字符、方法和比较前应先明确在哪一侧的类型域。

Java字符串与脚本字符串不同保存独立卡片。

原书依据 · 1 处

Rhino示例

下载器用GUI选择源和目标,再在新线程中分块传输并更新进度。图12-1已查看;代码展示互操作,但线程、进度未知值与异常资源释放都不能按演示直接视作完整可靠实现。

下载流程区分输入传输与展示

原书下载器先读取URL并让用户选择保存位置,取消时直接结束本次动作,确认后启动后台下载;下载阶段连接、读字节、写目标并报告进度。网络I/O不放在按钮回调里执行,有助于避免单次等待占住事件处理,但展示更新还须遵守GUI线程规则。图12-1是示例截图,不是本次实际运行结果。

结构图:图表示原书的职责流程,GUI更新的线程问题由后续卡单独说明。

flowchart LR
  A[输入URL] --> B[选择目标文件]
  B --> C{是否确认}
  C -->|否| D[结束本次动作]
  C -->|是| E[启动后台下载]
  E --> F[分块读入并写出]
  F --> G[报告进度或错误]

下载流程区分输入传输与展示保存独立卡片。

原书依据 · 1 处
后台下载不应直接混入界面线程

原例在下载线程里增加Swing组件并更新进度条,却未把这些更新调度回事件分派线程。多数Swing组件操作要求在事件线程执行,把I/O移到后台并不自动使直接GUI访问安全。应把慢传输与短界面更新按各自线程职责安排,不能以截图可展示就推断并发规则已满足。

后台下载不应直接混入界面线程保存独立卡片。

原书依据 · 1 处
未知长度需按业务含义判定

URLConnection的内容长度未知可为−1,零也可能是合法空内容;所以if(len)不能正确区分“长度可用于进度总量”。原例会把真值−1误当已知长度设置进度上限。显示下载百分比应先明确长度是否已知及范围是否可表示,不能把通用真假转换代替字段契约。

未知长度需按业务含义判定保存独立卡片。

原书依据 · 1 处
下载资源释放需覆盖异常出口

原例只在传输循环正常结束后关闭输入输出流,读取、写入或后续关闭抛错时,已有资源可能没有走到各自close。按钮回调外层try也不会跨线程捕获下载线程后来抛出的错误。资源清理需要覆盖各阶段失败与部分建立的状态,并与UI错误展示分开;记录错误文本不等于流已被关闭或目标文件已完整。

下载资源释放需覆盖异常出口保存独立卡片。

原书依据 · 1 处

12.2 用Node实现异步I/O

Node将JavaScript执行与进程、文件、网络和事件接口连接。本书以0.4演示CommonJS、回调、流、Buffer、文件系统和TCP;整段与所有代码已实读,以下保留机制并明确旧接口和示例缺口。

定时器安排后续回调关联本项背景,实质主要讲解在对应位置。

模块系统管理加载与依赖关联本项背景,实质主要讲解在对应位置。

原书依据 · 7 处

Node连接系统输入输出

Node以V8等运行组件执行JavaScript,并提供文件、进程、网络和HTTP接口,本节强调异步I/O与事件驱动用途。它不是浏览器DOM环境,也不能把“有异步接口”推成所有函数都异步或程序绝不阻塞。原书0.4及其安装、Buffer和流接口只属历史背景,当前使用要核对相应版本,不能据此认为仍只能源码编译或只能使用Unix。

Node连接系统输入输出保存独立卡片。

原书依据 · 1 处

异步结果需通过完成入口交付

异步调用可先返回,把稍后的结果或错误交给回调或事件入口;当前返回值不等于操作已完成。等待I/O无需占住这次JavaScript调用,却不阻止回调本身执行耗时计算,显式同步方法也仍会阻塞。应先说明完成和失败从哪里交付,而不是把所有嵌套函数或返回值都叫异步结果。

异步结果需通过完成入口交付保存独立卡片。

原书依据 · 1 处

模块加载与进程入口各有职责

本书用node program.js启动脚本,CommonJS require加载模块并取得其导出;通常的模块缓存不等于任意相似名字永远只执行一次。process.argv提供启动参数,env、cwd等反映进程环境,chdir和exit则改变运行状态。shebang的解释器路径需与实际部署对应,用户ID与信号也有平台边界,不能把这些宿主能力当语言核心。

模块加载与进程入口各有职责保存独立卡片。

原书依据 · 1 处

事件监听管理需区分生命周期

on/addListener注册可重复触发的监听,once只保留到一次触发,listeners用于观察监听集合,removeListener与removeAllListeners撤销相应注册。事件不等于新线程:普通Node EventEmitter按注册顺序同步调用监听,回调中的慢工作会影响发射过程。需要一次响应、长期订阅或撤销时,要分别表达生命周期,不能以“事件驱动”推断回调必然异步。

事件监听管理需区分生命周期保存独立卡片。

原书依据 · 1 处

进程通知不等于恢复与清理完成

exit、uncaughtException和信号事件提供不同运行通知。捕获未处理异常后打印日志并不证明状态已恢复,不宜据原例继续正常工作;process.exit也不会自动等全部异步I/O完成,更不是运行系统shutdown命令。应明确故障处理和退出完成契约,避免把收到事件或调用退出入口当成资源都已安全收尾。

进程通知不等于恢复与清理完成保存独立卡片。

原书依据 · 1 处

可读流按数据块交付输入

可读流用data交付数据块、end说明输入已无后续数据、error交付故障,pause/resume调节消费,setEncoding可让数据以指定文本编码呈现。一个块是此次提供的数据,不天然等于一个完整业务消息;字节边界与字符边界也不同。流式接口避免必须一次取得全文件,但缓冲、解码与消费速度仍需有相应契约。

可读流按数据块交付输入保存独立卡片。

原书依据 · 2 处

写入返回值表达背压信号

可写流write返回false时,当前块已被接收进入相应处理路径,但生产者不应继续无限增加新块,而应等drain再推进。这不是“该块写失败所以重发”的普通成功布尔值,也不证明数据已持久化到磁盘或被远端确认。忽略背压会持续堆积缓冲;end表示不再提交新数据,完整结束还需相应完成和错误入口。

结构图:流量协调示意,drain不表示持久化提交。

flowchart TD
  A[提交一个新数据块] --> B{write是否允许继续}
  B -->|是| C[准备下一块]
  C --> A
  B -->|否| D[暂停提交新块]
  D --> E[收到drain]
  E --> C

写入返回值表达背压信号保存独立卡片。

原书依据 · 1 处

缓冲区视图与复制有不同共享性

本书Buffer保存定长字节序列,0—255约束的是每个字节的值,不是缓冲区长度。slice取得共享视图时,修改视图会影响原缓冲;copy到另一个独立缓冲则有不同存储语义。不能把同样叫slice的接口一概当成浅拷贝数组,更不能由创建新对象推断字节已独立。现代分配应区分初始化与未初始化接口,旧new Buffer(number)不当作默认推荐。

缓冲区视图与复制有不同共享性保存独立卡片。

原书依据 · 1 处

文本编码决定字节与字符换算

字符串与字节序列之间需要编码约定。示例2πr含三个此处的文本字符,UTF-8占四字节;Buffer长度、写入偏移与切片范围按字节计,不按字符串length直接替代。write返回的已写字节数量用于界定随后解码的范围,不能把未写部分也当有效文本;跨数据块解码还需适用的流或解码状态。

文本编码决定字节与字符换算保存独立卡片。

原书依据 · 1 处

同步文件读取与回调读取分开

readFileSync按编码可直接取得文本并同步返回或抛错;回调式readFile把错误和缓冲结果交给完成函数,是否解码取决于接口参数。writeFile与同步版本也应按实际完成入口使用,书中缺回调的异步writeFile行不能直接当现代完整调用。读取到文本不等于已解析JSON,发起写入也不等于内容已可靠保存。

同步文件读取与回调读取分开保存独立卡片。

原书依据 · 1 处

复制完成需等待输出完成信号

fileCopy在输入end后调用output.end并立即通知done,只能说明输入已结束且请求关闭输出,不能证明全部写出已成功完成。现代可写流finish才表示相应写入已交给底层系统,仍不等于磁盘持久化保证。原例还忽略write背压和输出错误,输入错误直接throw也缺少统一收尾;复制契约需以目标版本的输出完成与两端错误共同判定。

复制完成需等待输出完成信号保存独立卡片。

原书依据 · 1 处

目录枚举需区分名字路径和属性

目录脚本先用readdir取得名字,再用path.join与目录组成路径,stat读取大小、时间和目录标记,最后格式化到标准输出。名字不是完整路径,stat元信息也不是文件内容;脚本中的同步接口会逐项阻塞,适合与其简短命令行用途一起评估,不能因Node框架异步就忽略这里的同步操作。目录变化或单项失败也未由原例完整处理。

目录枚举需区分名字路径和属性保存独立卡片。

原书依据 · 1 处

TCP回显按每个连接处理数据

本例net服务器监听端口后,为每个connection取得的流注册data与end处理,收到数据块便向同一连接写回。监听入口与每条连接的数据处理职责不同,实际回显还需按流契约处理错误与背压;它只是TCP字节流示范,不是完整应用消息协议或可直接部署的服务。代码在本轮仅阅读,没有监听端口或建立连接。

TCP回显按每个连接处理数据保存独立卡片。

原书依据 · 1 处

12.2.1 Node示例:HTTP服务器

HTTP服务器按URL分派延迟、镜像与文件处理,并通过请求事件取得主体、通过响应对象写出结果。原例是测试示范,不含完整路径边界、错误分类和流量协调。

可读流按数据块交付输入关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处
HTTP请求与响应职责分开

服务器监听后由request事件取得请求和响应对象;请求提供方法、URL、头及主体事件,响应负责状态、头、数据与结束。路由应在相应请求上下文内决定处理分支,发起异步文件读取不代表当前响应已经完成。这个职责区分可复用到延迟、镜像与文件服务,而不要求每个分支共享同一完成时机。

结构图:保留原文构造入口及两个未命名对象实现的协作;虚线表示事件交付或操作依赖,不表示名义类型继承。方法未给返回类型时不补造。

classDiagram
  class ServerFactory["http.Server(构造入口,非类型)"] {
    +Server() Object
  }
  class ServerObject["server实例实现(示意)"] {
    +listen(port)
    +on(name, f)
  }
  class RequestObject["request实现(示意)"] {
    method
    url
    httpVersion
    headers
    +on(name, f)
  }
  class ResponseObject["response实现(示意)"] {
    +writeHead(status, headers)
    +write(content)
    +end()
  }
  ServerFactory ..> ServerObject : 创建实例
  ServerObject ..> RequestObject : request事件参数
  ServerObject ..> ResponseObject : request事件参数
  RequestObject ..> ResponseObject : 本次请求处理写出响应

HTTP请求与响应职责分开保存独立卡片。

原书依据 · 1 处
延迟测试可先发部分响应

/test/delay先发送状态头及Sleeping文本,再用计时器稍后写done并结束响应。因此它模拟的是响应逐步完成,而不是整个响应都等到延时结束才开始。parseInt(url.query)||2000还会把零等假值改为缺省值,未完整限制负数、范围和查询格式,不能把这个测试参数当成健壮的时长协议。

延迟测试可先发部分响应保存独立卡片。

原书依据 · 1 处
镜像调试不等于原始报文保存

/test/mirror把已解析的方法、URL和头拼成调试文本,再随data事件把主体转写到响应,输入结束时结束输出。它有助于观察请求内容,却不是原始网络报文的逐字节保真记录;示例请求行甚至缺少部分分隔空格。主体块写入还需遵守响应流背压和错误契约,不能只因原文返回就视作完整代理实现。

镜像调试不等于原始报文保存保存独立卡片。

原书依据 · 1 处
文件路由需限定真实资源边界

仅去掉URL路径的第一个斜杠,不能保证fs.readFile访问始终局限在预期目录,表达式本身没有拒绝上级路径等越界含义。按扩展名选MIME也是显示约定,不证明内容经过验证。若作为文件服务使用,应明确URL到资源的允许映射与解析后范围,不能把这段教学拼接当成完整资源隔离。

文件路由需限定真实资源边界保存独立卡片。

原书依据 · 1 处
读取失败不全是资源不存在

文件读取错误还可能来自权限、I/O或其他故障,原例一律返回404会把不同失败原因混在一起;把底层err.message直接返回也可能暴露内部路径与细节。状态码、面向用户的消息和内部诊断各有职责,不能以有错误回调就推断错误分类已完整。响应成功的200分支同样需要确认所有输出阶段按契约结束。

读取失败不全是资源不存在保存独立卡片。

原书依据 · 1 处

12.2.2 Node示例:HTTP客户端工具模块

客户端工具模块按CommonJS导出GET与POST函数,建立请求、收集文本响应并在结束后回调。旧createClient接口、文本假设和缺少失败路径都使它不能直接作现代通用客户端。

私有模块通过明确出口暴露能力关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处
模块局部作用域不等于沙箱

CommonJS模块包装可使普通顶层局部声明不直接成为共享全局绑定,并通过exports等入口导出API;这不意味着模块不能显式访问全局对象、修改共享对象或调用文件进程能力。原书把特殊执行环境说成完全不能更改全局过强。加载隔离命名与安全隔离权限不同,不能把require当作运行不可信代码的沙箱。

模块局部作用域不等于沙箱保存独立卡片。

原书依据 · 1 处
请求发送与响应完成是两阶段

本例先建立HTTP请求、发送必要主体并调用end,再等待response事件及其data/end事件取得响应。调用请求end只表示请求提交结束,不表示服务器已回复或整个HTTP交换成功;状态、头和主体在另一阶段交付。旧http.createClient与默认80端口说明需放回0.4背景,不能推断已支持所有现代HTTP或HTTPS场景。

请求发送与响应完成是两阶段保存独立卡片。

原书依据 · 1 处
请求体表示应匹配内容类型

POST工具把Buffer当二进制、字符串当UTF-8文本、普通对象经querystring编码成表单,并设置相应Content-Type。内容类型表达的是所发送表示,不会替调用方验证所有数据类型、嵌套结构和长度。未覆盖的数字、函数等输入需要明确处理,不能因为typeof分支结束就假定任意值都能被request.write接受。

请求体表示应匹配内容类型保存独立卡片。

原书依据 · 1 处
响应聚合需明确文本与完成契约

工具先setEncoding(“utf8”),把所有响应片段连接为body,再在end调用callback(status,headers,body)。这假定响应是适合UTF-8的文本,也把整个主体保存在内存;它不是通用二进制或无限流处理。得到HTTP状态不等于业务成功,网络或流错误还可能没有进入该回调,必须分别明确传输失败、响应完成与应用判定的契约。

响应聚合需明确文本与完成契约保存独立卡片。

原书依据 · 1 处

第二部分 客户端JavaScript

第二部分将语言核心放进浏览器宿主,按窗口、文档、样式、事件、网络、库、存储与多媒体等能力展开。目录路线不代替后续正文阅读。

第13章 Web浏览器中的JavaScript

本章把静态信息文档与应用式页面视作连续谱,先提供浏览器运行上下文,再讨论嵌入、执行、兼容、可访问与安全。文档与应用的区分服务于功能目的,不是互斥标签。

13.1 客户端JavaScript

浏览器经窗口入口关联文档和元素,脚本可查询内容、调整呈现并响应事件。展开示例用类名切换内容可见性,再通过每次辅助调用的局部绑定保存点击目标。

闭包捕获的是活动作用域链而非快照关联本项背景,实质主要讲解在对应位置。

文本节点保留消息的数据语义关联本项背景,实质主要讲解在对应位置。

定时器安排后续回调关联本项背景,实质主要讲解在对应位置。

事件处理器由事件驱动调用关联本项背景,实质主要讲解在对应位置。

原书依据 · 23 处

浏览器对象连接文档与呈现

浏览器窗口入口关联document,Document查询或创建节点,Element承载内容、类名、样式和事件入口。语言核心与这些宿主对象职责不同;经典脚本可经window使用许多全局能力,但现代块级或模块绑定不能一律等同window属性。查询元素还可能未命中,不能未检查就读取firstChild。下面展示本段对象协作,不把它们混成一个拥有全部能力的对象。

结构图:对象可用接口视图,未单独命名实现用示意标签;实线为属性引用,虚线为查询或操作依赖,返回描述为语义而非虚构实现类型。

classDiagram
  class WindowObject["Window对象(示意)"] {
    document
    location
    +alert(message)
    +setTimeout(f, delay)
  }
  class DocumentObject["Document对象(示意)"] {
    +getElementById(id) Element或null
    +createTextNode(text) 文本节点
  }
  class ElementObject["Element对象(示意)"] {
    firstChild
    className
    onclick
    +appendChild(node) 节点
  }
  class StyleObject["style对象(示意)"] {
    backgroundColor
  }
  WindowObject --> DocumentObject : document 引用
  DocumentObject ..> ElementObject : 查询文档元素
  ElementObject --> StyleObject : style 引用

内容、呈现和行为协同的模式在本书时代常称动态HTML(DHTML),不表示它们已成为同一种语言或必须耦合在同一处代码。

同一页面的经典脚本共享全局环境;嵌入文档拥有自己的全局环境。文档之间能否直接访问须考虑同源等条件,“同一服务器”不是充分精确的权限判定。

浏览器对象连接文档与呈现保存独立卡片。

原书依据 · 3 处

类名状态需要与样式规则协作

展开示例以reveal和revealed两种完整className表示内容状态,点击标题后切换名字,由相应样式决定子内容是否显示。这样行为改变状态,CSS控制呈现;但整串等值判断并不自动支持任意额外类名。本地原书CSS写成.reveal与.reveal.handle,缺少意图中的后代选择空格,不能把这份排版直接当已验证可运行样式。

类名状态需要与样式规则协作保存独立卡片。

原书依据 · 1 处

13.1.1 Web文档里的JavaScript

面向信息的文档把脚本作为导航、展示和理解上的增强,而不是让基本内容必须依赖每个动态步骤成功。内容、呈现和行为组合在当时常称DHTML。

浏览器对象连接文档与呈现关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处
文档增强保留基础信息入口

面向信息传达的文档可用动画、排序和逐步展开帮助用户获取内容,但应先保证基础信息与导航有合适入口。脚本在此增强体验,不能把隐藏关键内容且脚本失败后无法取得它当作自然结果。原书强调这种用途与本质依赖程序交互的应用不同;具体降级方式仍需按任务和用户能力设计,而不是禁止全部交互。

文档增强保留基础信息入口保存独立卡片。

原书依据 · 2 处

13.1.2 Web应用里的JavaScript

应用式页面把浏览器当作提供网络、存储与图形等服务的平台。XMLHttpRequest允许局部取新信息而不整页刷新,浏览器像操作系统只是能力类比,不是相同权限模型。

局部数据更新不必整页重载

XMLHttpRequest使应用可在脚本中发起HTTP交换,获取新信息后更新局部内容,而不必每次重新加载整份页面。这是本书Ajax应用的重要机制,不意味着只有XML数据可用,也不自动解决加载中、失败和界面状态一致性。浏览器服务为应用提供持续交互的基础,网络异步结果还要通过相应完成入口处理。

局部数据更新不必整页重载保存独立卡片。

原书依据 · 2 处
浏览器服务不等于系统全权

本书把浏览器类比为简易操作系统,是为了关联网络、图形、本地存储、历史与后台任务等平台服务。类比不能推断脚本拥有本地程序的所有文件、设备或进程权限,也不代表每项API在任意上下文都开放。文档增强与程序式应用对脚本的依赖程度不同,应围绕其核心任务评估不可用时如何处理,而非一条规则套所有页面。

浏览器服务不等于系统全权保存独立卡片。

原书依据 · 2 处

13.2 在HTML里嵌入JavaScript

四种嵌入入口把脚本接到文档,核心设计判断是将内容与行为分离,不能把历史流行度描述当作当前统计。

脚本可内嵌或从文件载入关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

内容与行为分离减少耦合

将行为代码集中在脚本中,由它查询元素和注册处理器,可以让HTML主要表达内容,减少事件属性中散落的大段代码。外部文件还方便多页共用同一份实现。本书称这种取向为unobtrusive JavaScript;它是组织职责的原则,不是仅凭有没有内联脚本判断程序质量的机械标准。

内容与行为分离减少耦合保存独立卡片。

原书依据 · 2 处

13.2.1 <script>元素

内联脚本的解析取决于文档是HTML还是实际XML;时钟示例串联查询、取当前时间、更新显示与递归安排回调。

脚本可内嵌或从文件载入关联本项背景,实质主要讲解在对应位置。

定时器安排后续回调关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

13.2.2 外部文件中的脚本

外部脚本用于共享实现和潜在缓存复用,但下载来源并不提供页面权限隔离;缓存命中还有分区与策略前提。

脚本可内嵌或从文件载入关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处
脚本来源不提供权限隔离

外部经典脚本被页面引入并执行时,参与的是嵌入文档的运行环境;从另一个服务器下载,不等于被放进只能访问该服务器的隔离区。因此接入第三方脚本需要信任它所执行的代码,不能用下载域名不同推断其无法读改页面。同源约束关注文档间访问等具体操作,不能当成第三方脚本的自动沙箱。

脚本来源不提供权限隔离保存独立卡片。

原书依据 · 3 处
共享脚本缓存有命中条件

多页引用同一外部文件可以减少重复维护,并可能通过缓存减少再次下载,但命中还取决于缓存策略与浏览器分区。原书认为任意站点可直接共享一个公共CDN缓存副本,这不能作为当前普遍保证;Chrome的HTTP缓存分区就是反例。是否采用第三方托管还需考虑可用性与信任,不能仅根据假定缓存收益决定。

共享脚本缓存有命中条件保存独立卡片。

原书依据 · 2 处

13.2.3 脚本类型

script的类型参与决定执行方式;非执行的数据块需要明确类型,历史VBScript与language例子有时代限制。

脚本类型决定内容处理

script的type不仅是说明文字,也参与浏览器对内容的处理。可以用非执行类型嵌入内联数据并由脚本读取;指定未知类型并不会自动把src变成通用数据下载器。现代HTML还识别module、importmap和speculationrules,不能把所有非text/javascript值都归为无效脚本。嵌入数据仍受HTML解析上下文约束,不能推导任意文本原样放入总是安全。

脚本类型决定内容处理保存独立卡片。

原书依据 · 3 处

13.2.4 HTML中的事件处理程序

事件属性把HTML属性值转换为处理函数体,兼有宿主属性与JavaScript语法两层约束。

事件处理器由事件驱动调用关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处
事件属性具有两层语法

HTML事件属性里的文本会形成事件处理函数体,既要满足HTML属性值的引用规则,也要满足JavaScript语句语法。原书称任意多条语句用逗号分隔并不准确:逗号可组合表达式,不能替代所有语句分隔与结构。示例在change时用this.checked更新订单选项;把主要逻辑放到脚本中注册处理器可减少两层语法交织。

事件属性具有两层语法保存独立卡片。

原书依据 · 2 处

13.2.5 URL中的JavaScript

javascript:导航会执行代码,但只有字符串完成值才进入文档替换路径;void的意义是消除该值,而非阻止代码运行。书签脚本继承页面操作能力,未安装或运行。

导航脚本区分完成值类型

javascript:导航先执行脚本;当前HTML规则中,完成值是字符串时才把它作为HTML文档内容处理,非字符串不会先统一转成字符串再替换文档。void仍会求值其操作数,但使结果为undefined,可避免调用意外产生字符串内容。原书以window.open返回对象被转换为[object Window]解释替换,不应作为当前规则;完成值也不等同普通函数返回语句。

导航脚本区分完成值类型保存独立卡片。

原书依据 · 1 处
书签脚本参与当前页面环境

保存javascript:代码可形成bookmarklet,启动后能在相应页面环境中查询或改变文档。它是执行代码的入口,不是只读书签数据;是否允许执行还受导航上下文和策略限制。原书计算器用prompt收集输入并eval求值,仅作机制例子,未执行。普通界面动作通常应通过合适控件注册事件,不能由能写成URL推导所有资源URL位置都能使用它。

书签脚本参与当前页面环境保存独立卡片。

原书依据 · 1 处

13.3 JavaScript程序的执行

经典脚本可以共享页面全局环境,子文档有自己的全局环境;加载与事件只是理解用的两阶段模型,后文时间线还明确允许交错。

浏览器对象连接文档与呈现关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

加载与事件并非硬分界

先执行初始化脚本,再响应后续事件,是理解客户端程序的有用模型,但不能据此规定load必须是第一个事件、初始化固定持续一两秒,或所有脚本结束前绝不会处理事件。脚本加载方式、文档解析与已注册回调可以交错;本章后续时间线也明确承认解析未完成时可能交互。设计初始化要围绕所需资源是否就绪,而不是假定全局存在一个统一开关。

加载与事件并非硬分界保存独立卡片。

原书依据 · 2 处

13.3.1 同步、异步和延迟的脚本

解析器插入的普通经典脚本会暂停解析,defer与async改变下载及执行时机;动态插入脚本还需另看调度条件。

脚本加载策略改变执行顺序

对解析器插入的外部经典脚本,普通方式在取得并执行脚本前阻塞解析;defer并行获取,解析完成后按文档顺序执行;async并行获取,可用时尽快执行,不保证文档次序。两者都存在时按async处理。下载并行不等于JavaScript执行同时并行。现代module另有规则,不能把经典脚本的所有条件原样套用;本书的历史支持率不代表当前状态。

脚本加载策略改变执行顺序保存独立卡片。

原书依据 · 3 处
动态插入脚本也会执行

loadasync先创建script、设置src,再接入文档,从而引入后续执行的代码。它并非只下载一段文本供调用者安全检查,也不自动保证多个动态脚本按调用顺序完成。应明确依赖、完成与失败处理,不能在appendChild返回后就假定库已可用;具体加载器或现代模块方案需另按其契约处理。

动态插入脚本也会执行保存独立卡片。

原书依据 · 3 处

13.3.2 事件驱动的JavaScript

事件以类型和目标共同定位,回调注册不等于调用;多模块协作和迟注册都要求明确生命周期。

事件处理器由事件驱动调用关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处
事件身份包含类型与目标

click只说明事件类别,还要结合发生的目标对象,才能描述注册和处理的位置。事件对象进一步携带该次事件的细节。处理了业务逻辑不自动等于停止传播,阻止默认动作也不能代替停止传播;原书把“没有处理”与冒泡条件连写,不能据此认为返回业务成功便会结束传播。

事件身份包含类型与目标保存独立卡片。

原书依据 · 2 处
迟注册就绪回调需要补偿

本例onLoad在已记录load后以setTimeout(f,0)安排回调,否则注册load监听器,从而让调用者面对一致的异步调用方式。但loaded仅由此辅助代码安装的监听器维护:若整个辅助脚本在load之后才首次执行,初值false可能永远不被更新,不能把它当通用迟加载就绪检测器。零延时也不是立即同步调用;DOM已解析与所有资源已载入仍是不同条件。

迟注册就绪回调需要补偿保存独立卡片。

原书依据 · 1 处

13.3.3 客户端JavaScript线程模型

主线程长任务阻塞交互,拆分任务是在任务之间让出机会;Worker可独立计算但不能直接操作页面DOM。

长任务阻塞主线程响应

同一页面主线程上的长脚本会推迟后续交互和呈现。把计算拆成可结束的小任务,再安排下一步,可以在任务之间留出处理其他工作的机会;setTimeout并没有把计算本身搬到后台线程。拆分时还要维护跨步骤状态和进度,不能将单线程等同永无逻辑竞态,异步结果顺序仍可能产生错误。

长任务阻塞主线程响应保存独立卡片。

原书依据 · 3 处
后台计算需要明确通信边界

Worker让独立计算离开页面主线程,通过消息传回结果,由主线程更新文档;它不能直接操作页面DOM。本书以当时消息通信模型说明隔离,不能沿用为现代JavaScript永远没有共享内存或并行执行的结论,当前语言规范已定义共享内存及其同步语义。任务是否适合交给Worker还取决于通信和计算成本,不应为每个微小动作创建线程。

后台计算需要明确通信边界保存独立卡片。

原书依据 · 1 处

13.3.4 客户端JavaScript时间线

时间线按解析中、解析结束及资源完成区分就绪状态。它是简化图,不能把所有事件排到load之后。

加载与事件并非硬分界关联本项背景,实质主要讲解在对应位置。

脚本加载策略改变执行顺序关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处
文档就绪与资源完成不同

loading表示文档仍在解析,interactive表示解析完成,complete表示完成相应加载阶段。DOMContentLoaded关联解析完成及所需延迟脚本,而load等待页面相关资源;等待后者可能比只需DOM的初始化更迟。原文readystate应为readyState。async可能改变可见文档和执行时机,具体工作应等待实际依赖,不要把所有初始化统一放到“所有内容下载完”。

文档就绪与资源完成不同保存独立卡片。

原书依据 · 3 处

13.4 兼容性和互用性

兼容性来自平台演进、未实现与实现缺陷,不止有无某个同名成员。明确支持范围才能决定降级或补齐。

兼容判断需要区分缺失与缺陷

新旧环境差异、厂商未实现和已有实现的缺陷,需要不同处理。属性存在只能说明有这个入口,不能证明全部语义正确;应围绕实际依赖的功能与支持范围验证,再决定限制功能、补齐或降级。原书的ES3/ES5与IE6数据是历史背景,语言核心的后续演进同样可能产生兼容问题,不能认定只有DOM需要兼容性判断。

兼容判断需要区分缺失与缺陷保存独立卡片。

原书依据 · 2 处

13.4.1 处理兼容性问题的类库

兼容库有模拟标准能力和提供折中接口两种方式,其契约可能不同;框架也有明确版本和支持边界。

兼容封装不能凭空补齐语义

有些缺失能力可在既有机制上近似或完整模拟,有些受底层差异限制,只能提供较窄的统一接口。原书用addEvent封装addEventListener与attachEvent说明折中,不能因此宣称已经透明实现完整标准。采用库时应明确版本、支持环境和保留语义;使用框架减少差异处理,不代表永远无需考虑兼容。

兼容封装不能凭空补齐语义保存独立卡片。

原书依据 · 1 处

13.4.2 分级浏览器支持

分级支持把完整交互、基础内容和未充分测试区分开,书中脚注已说明Yahoo后续取消旧A级/C级列表。

支持等级定义验证承诺

对不同环境定义不同支持等级,可以明确哪些必须通过完整功能测试,哪些只承诺基础内容可用,以及哪些尚未充分验证。它是分配验证资源与沟通支持范围的方式,不能把未测试环境当成已经验证通过。原书Yahoo分级是历史实例,章节脚注还记载其2011年调整,不应照抄旧名单决定今天的流行环境。

支持等级定义验证承诺保存独立卡片。

原书依据 · 1 处

13.4.3 功能测试

能力检测依据实际接口,而不是猜厂商版本,但入口存在仍不保证完整语义。

兼容判断需要区分缺失与缺陷关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处
能力检测围绕实际依赖

先检测所需能力再选择实现,可减少对厂商名称和版本猜测的依赖。本例按addEventListener、attachEvent、属性赋值依次降级;这三条路径的行为契约仍可能不同。仅凭属性真值不能确认它可调用或正确实现所有需要的语义,因此应围绕具体需求检测与验证,不能认为未来同名接口必定无缺陷。

能力检测围绕实际依赖保存独立卡片。

原书依据 · 2 处

13.4.4 怪异模式和标准模式

doctype影响解析选择的兼容模式,compatMode只是模式的有限投影,不能验证整个文档是否合规。

兼容模式不代表文档合规

document.compatMode在怪异模式返回BackCompat,其他模式返回CSS1Compat。当前DOM还区分有限怪异与无怪异,CSS1Compat不能单独把它们分开;属性不存在也只能说明无法用该入口判断,不能直接证明怪异模式。HTML doctype参与模式选择,而不是开启所有标准能力或证明页面无错误的认证开关。

兼容模式不代表文档合规保存独立卡片。

原书依据 · 2 处

13.4.5 浏览器测试

当难以直接检测特定缺陷时,浏览器嗅探可作受限兼容分支,但不能取代实际能力与行为验证。

浏览器嗅探只宜限定缺陷

若某个已知缺陷无法可靠按行为检测,可以把特定兼容处理限定到相应平台范围。应记录缺陷、受影响条件与移除条件,而不是由浏览器名称推断所有能力。客户端Navigator或服务器User-Agent提供的是识别线索,不是安全身份或完整能力证明;新增版本也应重新核对范围,避免兼容分支持续扩张。

浏览器嗅探只宜限定缺陷保存独立卡片。

原书依据 · 4 处

13.4.6 Internet Explorer里的条件注释

IE条件注释与JScript条件编译是不同语法层的历史定向机制,例子还存在字符串缺引号。

条件注释属于历史兼容机制

旧IE的HTML条件注释可选择性包含标记,JScript条件编译则在脚本注释中用@if等选择代码,两者处于不同解析层,不能当成通用JavaScript条件语句。阅读旧代码时应先确定目标引擎和文档模式,再理解哪些内容被当作注释。原文IE分支alert字符串缺少结束引号,不宜原样执行;新方案不应凭历史例子假设这些机制仍普遍支持。

条件注释属于历史兼容机制保存独立卡片。

原书依据 · 1 处

13.5 可访问性

可访问性要求键盘与辅助技术能够取得信息、操作控件;禁用脚本只是本书提出的一项情境,不能代替真实任务验证。

文档增强保留基础信息入口关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

交互不能只服务鼠标用户

如果功能只挂在鼠标悬停或按下事件上,键盘用户可能无法触发它。应选用适合任务的语义控件、提供可到达的焦点和相应键盘操作,并验证辅助技术能理解内容与状态。原书提醒脚本不要成为信息壁垒,但不能把所有现代屏幕阅读器都当成不支持脚本,或仅凭禁用脚本后能看见文字就宣布应用可访问。

交互不能只服务鼠标用户保存独立卡片。

原书依据 · 1 处

13.6 安全性

浏览器能力与滥用限制相互影响,窗口类API的历史收紧说明API存在并非任何上下文都可用。

浏览器服务不等于系统全权关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

13.6.1 JavaScript不能做什么

浏览器对文件、网络、窗口和跨文档访问施加不同限制,不能由某一限制推出脚本绝无破坏能力。

平台限制需要逐项判断

浏览器有些能力不直接提供,有些只在满足用户选择、许可或上下文条件时开放。普通页面不能据任意路径自由读写本机文件,这不等于所有文件能力都不存在;弹窗、关闭窗口、跨文档访问和网络接口也各有规则。原书从缺少任意文件写入推出“不能删除数据或植入病毒”过强:漏洞、被授权操作及服务端动作仍需按实际能力评估,不能把沙箱当作无风险保证。

平台限制需要逐项判断保存独立卡片。

原书依据 · 1 处

13.6.2 同源策略

同源限制关注文档运行来源和被访问内容,跨源资源共享与消息通信是不同授权边界;document.domain属历史放宽路径。

脚本来源不提供权限隔离关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处
同源依据协议主机与端口

对本书讨论的普通HTTP(S)文档,源由协议、主机与端口共同确定,主机相同仍可能不同源。同源策略限制跨文档读取等操作,不意味着不同源资源一概不能加载或请求,也不是用户身份验证。嵌入页面的经典脚本按该文档环境执行,因此恶意代码一旦进入页面,就不能期待这项隔离自动区分它和页面自有代码。

同源依据协议主机与端口保存独立卡片。

原书依据 · 1 处
跨源共享不等于解除所有隔离

CORS通过HTTP协议条件允许跨源响应被共享,postMessage则在窗口之间传递消息,两者都不等于开放对另一文档任意对象的直接读写。CORS也不能替代服务端认证或保证请求绝不会到达;涉及凭据还有专门条件。消息接收方仍应验证来源与数据契约,不能仅因通信成功就信任消息内容。

跨源共享不等于解除所有隔离保存独立卡片。

原书依据 · 2 处
域名放宽是遗留兼容路径

旧document.domain方案通过双方设置可接受的共同域来放宽部分文档访问,不是把域字符串改成任意站点就获得权限。当前HTML规范明确不鼓励该setter,且在某些代理簇或沙箱条件下不生效或报错;不能用“两边赋同值”保证现代环境互访。新通信需求应按消息等明确边界设计,不把旧技巧当通用跨源方案。

域名放宽是遗留兼容路径保存独立卡片。

原书依据 · 2 处

13.6.3 脚本化插件和ActiveX控件

可脚本化插件扩大可信组件集合,因此浏览器自身限制不能自动覆盖扩展组件提供的能力。

扩展能力也扩展信任边界

若页面脚本能调用外部组件,实际可执行能力取决于浏览器与组件共同形成的边界。评估系统时要把组件暴露的文件、网络或原生接口纳入,而不能只检查语言本身有无这些API。书中Java applet、Flash和ActiveX是历史实例;当时对某些插件安全性的乐观评价不能作为今天继续使用它们的依据。

扩展能力也扩展信任边界保存独立卡片。

原书依据 · 1 处

13.6.4 跨站脚本

不可信查询参数被写入HTML输入流,会从数据变成代码。防御需要匹配输出上下文;手写简单HTML过滤并不容易可靠完成。

文本节点保留消息的数据语义关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处
输出上下文决定注入边界

示例将URL查询内容解码后拼进document.write,导致原本的数据进入HTML解析流程,攻击者可据此注入执行内容。问题核心是数据被解释为代码或标记,不要求必须由两个不同站点共同构成。只需显示文字时可用普通文本节点或适当文本接口;若确需允许HTML,应采用相应净化方案。解码、移除script字样或统一转义一套字符,都不能替代针对实际输出上下文的处理。

输出上下文决定注入边界保存独立卡片。

原书依据 · 3 处
隔离策略不能替代输出处理

iframe sandbox与CSP是不同机制:前者按令牌限制嵌入文档能力,后者通过策略约束资源和执行等行为。它们可用于分层防御,但不能由设置一个隔离属性推导所有不可信HTML都已安全,也不能替代适合输出位置的编码或净化。原书把sandbox称作“HTML5的内容安全策略”容易混淆两者;手写HTML净化函数也不应被描述为普遍简单。

隔离策略不能替代输出处理保存独立卡片。

原书依据 · 1 处

13.6.5 拒绝服务攻击

访问隔离不能自动约束CPU、内存和交互资源消耗,拒绝服务与窃取数据是不同问题。

长任务阻塞主线程响应关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处
隔离访问不保证资源可用

即使访问其他文档受到限制,脚本仍可能用长计算、大量内存或反复交互影响可用性。应把资源占用与信息读取分别考虑,不能因满足同源策略便认为页面不会阻塞。浏览器可能提供终止或限制措施,但原书的“没有通用办法”及“不常见”是时代判断,不作当前统计;正常应用也应避免造成同样的长任务负担。

隔离访问不保证资源可用保存独立卡片。

原书依据 · 1 处

13.7 客户端框架

框架封装底层API并可能裁剪未用代码,但仍需理解底层契约。框架清单及市场地位按出版年代处理。

高级封装仍需理解底层契约

框架可把常见操作组合为更高层接口,降低重复处理兼容性等问题的成本;使用者仍需理解它封装的事件、网络和文档契约,才能分析失败和越过封装边界的操作。库不会自动解决所有安全、可访问性和兼容问题,支持范围与版本也要明确。原书Prototype、Dojo、YUI、Closure、GWT清单是当时生态图,不是当前选型排名。

高级封装仍需理解底层契约保存独立卡片。

原书依据 · 1 处

第14章 Window对象

本章按计时器、导航、历史、环境信息、对话框、错误与跨窗口组织Window能力,名称不意味着每项都直接操作窗口。

14.1 计时器

计时器返回取消句柄,但安排后续执行不等于立即调用;invoke组合例的真实首调用时机与参数分支需要按代码读取。

定时器安排后续回调关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

组合定时器先核对首次触发

invoke的重复分支先等待start才创建interval,创建时并没有立即调用f,因此第一次f还需再等一个interval,而非注释暗示的仅等待start。end计时从repeat运行时开始,if(end)也使0不触发停止安排。模式由实参数量而非interval是否有效决定,且函数未返回取消句柄;使用这种封装前应核对首调用、结束边界和取消能力。

组合定时器先核对首次触发保存独立卡片。

原书依据 · 2 处

计时器字符串会再次求值

把字符串交给计时器意味着稍后将它按代码求值,与传入已经定义的函数不同。可直接传函数和所需数据时,不必把数据拼接成代码;否则会引入额外解析和注入边界。原书对额外参数的旧IE限制是时代条件,不能据此推断当前所有环境都禁止它们。

计时器字符串会再次求值保存独立卡片。

原书依据 · 2 处

14.2 浏览器定位和导航

Location是导航对象,Document.URL是只读字符串接口;只读不意味着永远保留首次载入值。

只读地址不等于首次快照

Location对象提供当前地址和导航操作,Document.URL则返回文档地址的字符串。属性只读或值为字符串,并不等于地址变化后该属性始终返回首次载入值;当前DOM定义它序列化文档的URL。原书声称片段导航不更新document.URL,不能作为现代规则。引用对象、不可写属性与永久快照是三种不同含义,不能混在一起。

只读地址不等于首次快照保存独立卡片。

原书依据 · 3 处

14.2.1 解析URL

地址分解与查询参数解析不是同一责任;手写urlArgs只覆盖很窄的输入格式。

地址分量保留各自边界

location.href给出完整地址文本,protocol、host、hostname、port、pathname、search、hash分别表示分量。host可含端口,不能与hostname混用;search通常带前导问号,hash通常带井号,不能把两者当成已解码的普通参数值。属性名是小写search,原书Search排版不能照抄;decodeURIComponent属于语言核心,不是浏览器专有函数。

地址分量保留各自边界保存独立卡片。

原书依据 · 4 处
查询参数解析不能只拆等号

本例按&分项、按首个等号分名值,只解码值并将同名键覆盖到普通对象,因此丢失重复项,也未解码键、未把表单格式中的+当空格,缺少等号的项被跳过。格式不合法的百分号编码还可能令decodeURIComponent抛错。应先确定所用查询格式和重复项契约,再选择解析方法;字典键还可能与普通对象继承成员冲突,不能把示例当完整通用解析器。

查询参数解析不能只拆等号保存独立卡片。

原书依据 · 1 处

14.2.2 载入新的文档

assign与replace的差异在历史条目,直接赋值也可触发导航;检测不存在的全局入口时要避免先触发引用错误。

替换导航避免返回重定向页

assign导航通常留下可返回的当前条目,replace以新导航替换当前条目,适合不希望后退立即再次进入无条件重定向的中转页。reload是重新载入当前文档。相对地址还需结合适用基准解析,不能只凭字符串判断目标;设置片段与加载另一文档也不是同一类结果。选择接口应依据希望保留的用户导航历史。

替换导航避免返回重定向页保存独立卡片。

原书依据 · 2 处
检测缺失全局避免先解引用

若XMLHttpRequest这个标识符根本未定义,直接在if中求值会先抛ReferenceError,无法进入静态页面降级分支。可以在确认的全局对象上查成员,或按所处词法环境使用适当的typeof检测,再核对入口是否满足需要。能力检测应能够在目标能力缺失时自行完成,不能让检测语句本身先依赖该能力。

检测缺失全局避免先解引用保存独立卡片。

原书依据 · 1 处

14.3 浏览历史

历史接口提供条目遍历,不开放任意历史URL枚举;应用状态与文档并非总是一对一。

历史条目可以表示应用状态

history.back、forward和go按会话历史条目移动,不应把每个条目都理解成一次新文档下载。动态应用状态与子框架导航都可能影响后退结果;length也不是可读所有历史URL的授权。应用若希望支持前进后退,需要保存可恢复的状态并在相应遍历时重建视图,不能只改变界面却假设浏览器自动知道业务状态。

历史条目可以表示应用状态保存独立卡片。

原书依据 · 3 处

14.4 浏览器和屏幕信息

Navigator与Screen提供不同环境线索,随后分别解释其局限。

14.4.1 Navigator对象

浏览器识别字段有兼容伪装和引擎版本歧义;联网标志也不能证明某个服务可达。

浏览器嗅探只宜限定缺陷关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处
联网标志不能证明服务可达

navigator.onLine为true只能提供可能在线的线索,不能证明互联网可达、更不能证明某个接口请求成功;实际操作仍需处理超时和失败。原书建议离线保留本地状态有启发,但持久化成功和联网恢复后的同步仍需单独确认,不能由一个布尔值决定所有数据是否已提交。

联网标志不能证明服务可达保存独立卡片。

原书依据 · 3 处

14.4.2 Screen对象

Screen提供屏幕信息而非页面内容区尺寸;网页适配需要选对测量对象。

屏幕尺寸不等于页面视口

screen.width和height描述暴露给网页的屏幕区域,availWidth和availHeight描述可用屏幕区域,不是当前页面内容视口的宽高。当前CSSOM View以CSS像素定义相关区域,也存在隐私或模拟等考虑,不能据此推断精确物理像素。页面布局应围绕实际显示空间和用户需求设计,不能看到屏幕较小就自动缩小字体损害可读性。

屏幕尺寸不等于页面视口保存独立卡片。

原书依据 · 3 处

14.5 对话框

简单对话框返回不同语义;参数驱动的旧HTML模态窗口例子展示入参和返回值,但有接口时代与HTML拼接边界。

对话框取消不是空字符串

confirm返回确认与否的布尔结果;prompt返回输入字符串或取消时的null,不能把取消和确认输入空串混为一谈。对话框呈现的是普通文本,不会把消息当HTML模板。阻塞式交互还可能中断用户流程,当前浏览器可限制或抑制显示,因此不能用它充当可靠的后台作业状态界面。

对话框取消不是空字符串保存独立卡片。

原书依据 · 2 处

模态表单要明确输入输出

历史showModalDialog例用dialogArguments传标题与字段标签,Okay读取各输入的value组成数组并设置returnValue,Cancel直接关闭而不提供该数组。图14-1的x/y/z为2、3、5,对应这一参数驱动表单;它只展示当时界面,不证明当前支持。模板把标签拼入innerHTML还要求输入可信或恰当处理,表单内按钮的默认提交行为也应另行明确。

模态表单要明确输入输出保存独立卡片。

原书依据 · 1 处

14.6 错误处理

全局错误观察不是恢复失败操作。当前特殊onerror参数与返回取消语义不同于原文跨浏览器概括。

全局错误观察不等于恢复

window.onerror可观察传播到全局的脚本错误;当前特殊处理器可收到消息、源地址、行、列和错误对象,并以true取消默认错误报告。原文把行号称字符串、把false说成通常抑制报告,不能作为当前契约。抑制报告不恢复已中断操作,也不自动覆盖资源加载错误或未处理Promise拒绝的所有情形;业务可恢复错误仍应在适合的责任边界处理。

全局错误观察不等于恢复保存独立卡片。

原书依据 · 3 处

14.7 作为Window对象属性的文档元素

命名属性使标记名进入全局查找,易与平台入口冲突;显式查询能使依赖更清楚。

命名元素不宜隐式当全局

元素id或部分name可能通过Window命名访问出现,但会与已有平台属性及显式绑定冲突,结果还可能是集合或嵌套窗口引用。代码依赖这种隐式名称,容易因标记或平台扩展而改变对象。应显式查询元素、检查未命中并保存在明确变量或命名空间中,不能只把HTML名字写成标识符就假定它始终指向唯一元素。

命名元素不宜隐式当全局保存独立卡片。

原书依据 · 5 处

14.8 多窗口和窗体

标签页、窗口与iframe各有浏览环境,存在引用关系不代表可以不受限制读写对方文档。

窗口关系不等于文档访问权

新窗口和嵌套框架各有自己的全局与文档环境;父子、打开者或命名关系帮助代码取得窗口引用,但直接操作其中内容还受源与其他隔离条件限制。不能把同桌面窗口中的多个标签看成共享一个全局,也不能把知道某个窗口存在等同读取其文档。无法直接互访时可设计明确的消息协作,而不是绕过隔离。

窗口关系不等于文档访问权保存独立卡片。

原书依据 · 3 处

14.8.1 打开和关闭窗口

open既可创建也可定位已有目标,返回引用和允许访问还各有条件;关闭窗口不等于删除已有JavaScript引用。

打开窗口不保证得到可用引用

window.open可以创建新上下文或选择允许导航的已有命名目标;调用可能被阻止,不能直接假设返回值可解引用。当前接口还可能因noopener返回null,或没有可用opener关系。是否得到引用、是否已完成加载、是否允许读写文档,是不同检查。原书四参签名及保证opener恒成立的例子属历史说明,不作当前通用契约。

打开窗口不保证得到可用引用保存独立卡片。

原书依据 · 2 处
窗口名称选择目标而非授权

open第二参数和链接target可用名称选择目标,但猜到一个名字不意味着有权限控制任意窗口。_blank、_parent和_top表达不同导航目标,命名复用也不能替代源与导航权限检查。窗口大小或工具栏等features只是向浏览器提出请求,实际还受策略和用户设置影响,不能用它保证固定桌面布局或隐藏必要界面。

窗口名称选择目标而非授权保存独立卡片。

原书依据 · 2 处
关闭窗口与持有引用不同

close尝试关闭浏览上下文,能否关闭受浏览器规则限制,不是对任意窗口都有效。已有脚本变量不会因窗口关闭自动消失,可用closed等状态协助判断,不能继续假定其中的文档和方法可用。嵌套iframe的移除与关闭顶级窗口不同;不要把Window.close与Document.close混用,后者涉及文档写入流。

关闭窗口与持有引用不同保存独立卡片。

原书依据 · 2 处

14.8.2 窗体之间的关系

框架关系属性定位浏览环境,iframe元素和框架窗口是不同对象。frames是窗口索引视图而非元素数组。

框架元素与框架窗口分开

iframe元素属于父文档的DOM;contentWindow指向它的子浏览环境窗口代理,frameElement则在允许时反向取得嵌入元素。parent与top沿环境关系定位祖先,不自动授予文档访问权。frameElement返回null也可能来自访问条件等限制,不能仅据null判定一定处于顶级窗口。下图保留本段实际属性名,箭头表示引用关系而非类继承。

结构图:父子窗口和元素的属性视图,均为示意对象;属性可能受访问条件限制。

classDiagram
  class ParentWindow["父窗口(示意)"] {
    document
    frames
  }
  class ParentDocument["父文档(示意)"] {
    +getElementById(id) 元素或null
  }
  class FrameElement["iframe元素(示意)"] {
    contentWindow
    name
  }
  class ChildWindow["子窗口(示意)"] {
    parent
    top
    frameElement
  }
  ParentWindow --> ParentDocument : document
  ParentDocument ..> FrameElement : 查询
  FrameElement --> ChildWindow : contentWindow
  ChildWindow --> FrameElement : frameElement 条件允许时
  ChildWindow --> ParentWindow : parent

框架元素与框架窗口分开保存独立卡片。

原书依据 · 2 处
窗口索引不是元素数组

frames[0]取得子框架窗口引用,不是iframe元素;length描述直接子框架数量,不能解释为编号或所有后代总数。当前规范中frames、window和self返回同一窗口代理,呈现可按索引访问子窗口的视图;本书末尾“frame不等于window”含名称混乱,不能用来推翻前面自引用定义。需要元素本身时应查询DOM或在允许条件下使用frameElement。

窗口索引不是元素数组保存独立卡片。

原书依据 · 2 处

14.8.3 交互窗口中的JavaScript

跨窗口共享函数保留其定义环境,不会因调用者不同重新绑定词法变量;不同realm的原型身份需要与值类型分开。

闭包捕获的是活动作用域链而非快照关联本项背景,实质主要讲解在对应位置。

原书依据 · 7 处
跨环境身份检查需看原型来源

不同窗口有各自的内建构造器和原型,因此来自另一环境的对象不必满足当前环境构造器的instanceof。要区别原始字符串与String包装对象,不能用一个instanceof概括字符串值;给当前String.prototype加方法也不意味着另一环境的包装对象继承它。原例var Set=top.Set()误调用而非保存构造器引用,应区分top.Set与top.Set()再理解new的对象来源。

跨环境身份检查需看原型来源保存独立卡片。

原书依据 · 1 处
窗口代理可跨导航保持引用

窗口引用通常指向WindowProxy,它把属性操作转交到相应的当前Window;新文档导航可能更换内部全局环境,而调用方保留的代理引用仍在。稳定引用不保证原文档仍存在,也不保证导航后仍同源。现代全局词法与模块绑定仍不能都当作Window属性;窗口代理也不等同用户可随意编程替换的普通Proxy实例。

窗口代理可跨导航保持引用保存独立卡片。

原书依据 · 1 处

第15章 脚本化文档

本章以DOM组织选取、遍历、属性、内容、结构和表单,Document是入口而非全部节点本身。

15.1 DOM概览

实例节点包含树与节点类型继承图是两种结构。元素、文本、注释和片段承担不同责任。

节点包含与类型继承分开

图15-1展示具体文档中的父子节点关系:p可以依次含文本、i元素及另一段文本,不能把整段可见文字视作一个文本节点。图15-2则是Node等接口的类型层次,边不是文档包含关系。Document是文档根入口,html是文档元素,二者不同;空白和注释也可能参与实际节点树,不能按排版截图断言只存在图中这些节点。

节点包含与类型继承分开保存独立卡片。

原书依据 · 4 处

节点接口按责任区分类型

Node是通用节点接口,Document、Element、CharacterData和Attr等在该基础上承担不同职责;Text与Comment共享字符数据能力。DocumentFragment是可持有子节点的片段容器,不能因它不直接作为普通文档元素显示就说没有实际节点。下图保留本段核心类型,不把属性当成元素子节点。

结构图:接口继承视图;本书HTMLDocument子类表述是历史视图,当前HTML把HTMLDocument作为Document遗留别名,因此不在下图虚构独立继承类。

classDiagram
  class Node {
    +appendChild(newChild) Node
    +removeChild(oldChild) Node
    +cloneNode(deep) Node
  }
  class Document {
    +createElement(localName) Element
    +createTextNode(data) Text
  }
  class Element {
    +getAttribute(name) DOMString?
    +setAttribute(name, value) undefined
  }
  class CharacterData {
    +appendData(data) undefined
    +substringData(offset, count) DOMString
  }
  class Text {
    +splitText(offset) Text
  }
  Node <|-- Document
  Node <|-- Element
  Node <|-- CharacterData
  Node <|-- Attr
  Node <|-- DocumentFragment
  CharacterData <|-- Text
  CharacterData <|-- Comment
  Element <|-- HTMLElement
  HTMLElement <|-- HTMLInputElement

节点接口按责任区分类型保存独立卡片。

原书依据 · 3 处

15.2 选取文档元素

取得Element引用是后续操作的前提,查询途径由标识、名称、标签、类和选择器等条件决定。

15.2.1 通过ID选取元素

id应唯一,查询仍可能未命中;getElements辅助函数把未命中转成异常,是其自行设定的契约。

按标识查询仍要处理缺失

getElementById按标识取得元素,未找到时返回null,而不是自动创建元素。文档应保持id唯一,但查询成功也不能作为整个文档唯一性校验:当前DOM返回树顺序中首个匹配。示例getElements把任一缺失转换为异常并返回id到元素的映射;这是辅助函数的额外契约,调用方应先决定缺失应中止还是允许部分结果,不能把它误认为原生查询自带行为。

按标识查询仍要处理缺失保存独立卡片。

原书依据 · 1 处

15.2.2 通过名字选取元素

name允许同名组,查询返回多个元素;通过命名属性直接访问仍可能冲突。

命名元素不宜隐式当全局关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处
名字查询返回同名元素组

name与id责任不同:name可由多个表单控件等共同使用,getElementsByName返回匹配HTML元素的实时NodeList,而不是保证一个结果。应按组的实际数量和任务处理,不把集合直接当Element使用。当前HTML在Document上定义这项接口,原书将它简单归为独立HTMLDocument子类专属属于旧接口视图。

名字查询返回同名元素组保存独立卡片。

原书依据 · 1 处

15.2.3 通过标签名选取元素

标签查询按范围返回元素集合,集合实时性与其只读访问不是同一属性。文档特殊入口也可能尚未存在。

标签查询范围限定后代

Document与Element都能按标签查询,Element版本只考虑其后代,不把调用元素本身算进去;星号匹配元素,不能把文本或注释也当结果。当前接口返回HTMLCollection,原书统称NodeList不准确。HTML标签的大小写规则不能无条件套到XML或混合命名空间,查询后仍应处理空结果再取第一个元素。

标签查询范围限定后代保存独立卡片。

原书依据 · 1 处
实时集合随文档变化

getElements类接口或某些文档集合会随DOM变化更新成员;遍历时同时增加或删除匹配元素,索引和length可能改变,导致跳项或重复处理。需要固定目标时可先取元素引用的静态列表再改文档,但这只是成员列表快照,里面的节点对象仍然可变。不能因结果不能像数组那样直接赋索引,就误以为所指节点或成员永不变化。

实时集合随文档变化保存独立卡片。

原书依据 · 6 处
文档入口需要检查存在时机

documentElement、head和body分别表示根元素与特定文档部分,集合如forms、images和links又是另一类入口。HTML解析器可隐式创建某些元素,但不等于任意读取时刻或任意Document实例里都已经存在,应在所需结构就绪后访问并处理null。links还包括带href的area,不只a;文档集合也不能等同页面上的所有可点击对象。

文档入口需要检查存在时机保存独立卡片。

原书依据 · 2 处

15.2.4 通过CSS类选取元素

类名参数以空格区分所需token,多项表示同时包含,不是选择器列表的并集。

实时集合随文档变化关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处
类名列表要求全部匹配

getElementsByClassName的参数是空格分隔的类标识符集合,要求目标同时包含这些标识符,顺序无关;不是用逗号表示任一类命中。Element版本只查后代,返回实时HTMLCollection,修改class也可能即时改变集合成员。怪异模式下的大小写规则还应按文档模式处理,不能把CSS类、HTML属性名和JavaScript属性名的规则混为一谈。

类名列表要求全部匹配保存独立卡片。

原书依据 · 3 处

15.2.5 通过CSS选择器选取元素

选择器表达匹配条件,查询还需明确首个/全部、空/非法以及静态成员范围。

选择器关系决定匹配范围

空格组合子选择后代,>选择直接子元素,逗号组合多个选择组;把这些关系混用会得到不同目标。body>h1:first-child要求h1本身是body的第一个元素子节点,而不是无论前面有什么都取第一个h1。span.fatal.error要求同一个span同时有两类,不能解释为error后代。选择器字符串是一套独立语法,不能直接把任意未转义输入当作合法选择器。

选择器关系决定匹配范围保存独立卡片。

原书依据 · 3 处
查询快照只固定成员列表

querySelector返回树顺序中的首个匹配或null,querySelectorAll返回调用时匹配成员的静态NodeList,未命中时为空列表。非法选择器会抛错,和正常未命中不同。静态只固定结果成员,不冻结节点;之后修改已选节点仍会改变文档,新增匹配节点也不会自动进入旧结果。

查询快照只固定成员列表保存独立卡片。

原书依据 · 1 处
查询结果范围与匹配上下文分开

在Element上查询时,最终结果限定在它的后代,但选择器可能利用范围外祖先作为匹配条件;不能机械地把选择器当成仅对该元素内部字符串解释。伪元素又不是真实Element,不能据CSS能画出它就期待querySelector返回相应节点。实现和支持集合仍需确认,jQuery选择器入口也不能仅因长得像CSS便宣称所有细节等同原生查询。

查询结果范围与匹配上下文分开保存独立卡片。

原书依据 · 1 处

15.2.6 document.all[]

document.all属于遗留兼容接口,新代码应使用明确的标准查询。

遗留全集接口保留维护背景

document.all在历史代码中可按编号或名字访问元素,有助于识别旧DOM编程方式。新代码应选择getElementById、标签或选择器查询等有明确范围和返回契约的入口,而不是继续依赖这种全集对象。它的特殊兼容行为也不适合作为普通对象规律的示例;本段保留的是旧代码识别价值,不是推荐新增用法。

遗留全集接口保留维护背景保存独立卡片。

原书依据 · 1 处

15.3 文档结构和遍历

文档可按所有节点或仅元素遍历,决定后续应采用哪组关系属性。

15.3.1 作为节点树的文档

节点关系可能经过文本、注释或doctype,链式固定索引不能代替结构查询。

节点遍历要考虑非元素节点

childNodes是直接子节点的实时列表,firstChild、lastChild和兄弟关系可包含文本、注释等非元素节点。文档首子节点也可能是doctype,不能固定把document.firstChild当html再按索引找body。空白是否形成节点还受HTML解析规则影响;应检查节点类型或采用元素遍历,而不是以一次无空白样例决定所有文档的结构。

节点遍历要考虑非元素节点保存独立卡片。

原书依据 · 2 处
节点类型帮助解释关系和值

nodeType可区分Document=9、Element=1、Text=3、Comment=8、DocumentFragment=11;nodeValue对文本和注释给出数据,而不是所有节点都有相同文本含义。nextSibling向后、previousSibling向前,原书previoursSibling为拼写错误。HTML元素nodeName常为大写,不能把该习惯推广到XML节点名,亦不能将节点名当可见文本。

节点类型帮助解释关系和值保存独立卡片。

原书依据 · 3 处

15.3.2 作为元素树的文档

元素遍历过滤非元素节点,但兼容辅助代码必须保存边界和返回契约;用数组模拟实时集合不完全等价。

遗留访问器接口需标出版次关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处
元素遍历过滤文本和注释

children只收直接子元素,firstElementChild、lastElementChild与元素兄弟接口可避免手动跳过文本和注释。当前children属于标准HTMLCollection,childElementCount是数量;不能沿用原书“非标准NodeList”的接口分类。若需文本位置则仍用节点视图,过滤非元素并不总是正确,取决于任务要处理的内容。

元素遍历过滤文本和注释保存独立卡片。

原书依据 · 2 处
遍历封装需统一越界结果

parent、sibling和child的封装有不同索引起点与边界,调用前要明确整数输入和越界契约。本例child承诺不存在返回null,但children[n]正向越界可能返回undefined;sibling的previousElementSibing拼写也导致原生分支失效而退到手动遍历。若n不是有限整数,循环还可能偏离预期。不能因为函数注释写了契约便跳过逐分支对照。

遍历封装需统一越界结果保存独立卡片。

原书依据 · 1 处
模拟集合要保留更新契约

用getter每次遍历生成数组,可在读取当时得到子元素,但已保存的数组不会随DOM变化,不能替代真正实时children集合的所有语义。兼容层应声明这种差异而不是只提供同名入口。扩展宿主原型还影响环境中的其他代码和命名空间;本书defineGetter写法是旧兼容技术,不应称为普遍完美移植。

模拟集合要保留更新契约保存独立卡片。

原书依据 · 1 处

15.4 属性

HTML内容属性与DOM对象属性有映射关系但不是同一套接口,随后分别读取。

15.4.1 HTML属性作为Element的属性

DOM反射属性可能暴露布尔、数字或对象,不应以字符串属性规则统一解释。

对象属性不总是标记字符串

HTML内容属性通常是文本,DOM反射属性却可能是字符串、布尔、数字、对象或关联元素。className、htmlFor等名字也不能用一条小写或加html前缀规则机械生成,必须按具体接口确认。事件处理器属性保存函数或null,style提供样式声明对象;delete对象属性不等于移除HTML内容属性,应使用相应DOM入口。

对象属性不总是标记字符串保存独立卡片。

原书依据 · 2 处

15.4.2 获取和设置非标准HTML属性

内容属性接口按名称读写字符串,布尔属性以存在性表示开关;命名空间接口要分本地名与限定名。

布尔属性按存在性表达开关

getAttribute读取属性文本,缺失时返回null;setAttribute写入字符串,hasAttribute检查存在,removeAttribute才移除内容属性。HTML布尔属性的存在表示真,因此写disabled=“false”也不是关闭disabled;应按任务使用反射布尔属性或移除内容属性。通用属性API也可处理标准属性,不仅限于原书标题中的“非标准”属性。

布尔属性按存在性表达开关保存独立卡片。

原书依据 · 2 处
命名空间与前缀不是一回事

命名空间感知的属性操作按命名空间URI与名称定位。读取、存在和删除通常接收本地名,setAttributeNS则接收可含前缀的限定名和对应值;不能把前缀字符串当命名空间身份。相同本地名在不同URI下可以表示不同属性,转换或删除时应保留这一边界。

命名空间与前缀不是一回事保存独立卡片。

原书依据 · 6 处

15.4.3 数据集属性

dataset提供data属性的双向字符串视图,示例文本解析与变量拼写不足以形成可靠火花线绘图。

数据属性通过字符串映射

data-*可保存元素关联的自定义数据,dataset按命名转换提供双向入口,例如data-jquery-test对应jqueryTest。它不是自动带类型的业务模型:读取值仍需转换和校验,设置或删除相应成员会影响内容属性。数据属性没有自身固定视觉效果,但CSS和脚本仍可引用它,因此不能推断改变它永远不影响表现。

数据属性通过字符串映射保存独立卡片。

原书依据 · 2 处
文本数字需按数据格式解析

火花线正文是空白分隔的数值序列,但split(“”)按字符拆分,会把空格变成NaN并把多位数拆开,不能当通用数据读取。备用示例又把data-ymax赋给ymin,未正确取得ymax;读取的data-points在给出标记里也不存在且未使用。应先明确分隔、空值、数值范围及上下界契约,再交给绘图函数,不能把未实现的drawSparkline算成已验证效果。

文本数字需按数据格式解析保存独立卡片。

原书依据 · 1 处

15.4.4 作为Attr节点的属性

属性集合返回Attr对象而非直接字符串,也不属于文档子节点遍历。

属性节点集合不等于子节点

Element.attributes是NamedNodeMap,访问得到Attr,name和value分别给出属性名和值;它与childNodes的文档包含关系不同。集合可随属性增删更新,遍历中修改仍需考虑成员变化。当前DOM在Element而不是所有Node上定义attributes,不能由原书“其他节点返回null”推断任意节点都有该属性。要取文本值通常用明确的属性API更直观。

属性节点集合不等于子节点保存独立卡片。

原书依据 · 2 处

15.5 元素的内容

同一元素内容可表示为标记字符串、纯文本或节点序列,三种表示保留的信息不同。

内容表示决定保留的信息

同一段内容可作为HTML标记、纯文本或节点树处理:标记表达结构,文本表达字符,节点视图保留对象与包含关系。选择哪种表示,应看要显示文字、解析结构还是移动已有节点;从一种表示转成另一种,可能丢失格式、节点身份或关联状态,不能认为三种入口可以无条件互换。

内容表示决定保留的信息保存独立卡片。

原书依据 · 2 处

15.5.1 作为HTML的元素内容

innerHTML替换内部内容,outerHTML替换元素本身,相邻插入则有四个不同位置;字符串解析并非保留原节点身份。

输出上下文决定注入边界关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处
重写标记会替换原有节点

读取innerHTML取得内容的标记表示,赋值则解析字符串并替换内部节点。反复用+=并非简单接到已有Text后面,它会先序列化再解析重建,除了性能成本,还可能丢失原节点上以对象身份关联的状态。outerHTML赋值进一步替换元素本身,旧变量不会自动改指向新元素;应按是否要保留节点选择更新方式。

重写标记会替换原有节点保存独立卡片。

原书依据 · 2 处
相邻标记插入分清内外

insertAdjacentHTML的beforebegin与afterend在目标元素外,afterbegin与beforeend在其内容开头和结尾。图15-3把四个位置标在同一div的两侧,不能把beforeend误作元素外后方。接口解析传入的HTML,应对内容信任和具体父节点上下文负责,不能因为只做插入就忽略注入边界。

相邻标记插入分清内外保存独立卡片。

原书依据 · 1 处

15.5.2 作为纯文本的元素内容

textContent聚合后代文本,innerText关注渲染文本,两者不是语义完全一致的兼容别名。script数据块仍受解析边界约束。

文本节点保留消息的数据语义关联本项背景,实质主要讲解在对应位置。

脚本类型决定内容处理关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处
文本聚合与渲染文本不同

textContent聚合后代文本,innerText关注渲染后的文本,空白、隐藏内容等可能不同。当前innerText已有HTML规范,不能沿用原书没有明确行为的永久判断。检测接口时也应把空字符串与属性不存在分开,不能用||把有效空内容当成不支持;读取与写入行为应按实际需求选择,不能只看名字相近就替换。

文本聚合与渲染文本不同保存独立卡片。

原书依据 · 1 处

15.5.3 作为Text节点的元素内容

手动聚合文本按节点类型递归;修改CharacterData可保留包含节点但仍需核对实际分支。

递归聚合只保留指定节点文本

示例遍历子节点,只拼Text和CDATASection的数据,并对Element继续递归,注释等被略过。它适合说明后代文本聚合,不是对任意Node都完整复刻textContent:直接传Text作为根时不会返回根自身内容。收集字符顺序由节点遍历决定,不能用可见排版推断会自动加入词间空格或换行。

递归聚合只保留指定节点文本保存独立卡片。

原书依据 · 2 处
文本变换需要命中正确类型

upcase意图把Text与CDATASection的数据改为大写,但第二分支把nodeType拼成nodeTyep,导致CDATA节点未按意图处理。直接设置data可改变现有字符节点内容,而无需把整段父节点序列化重建;此类遍历仍应明确根类型、要略过的区域和语言转换是否符合业务,不把“全部大写”当无损标准化。

文本变换需要命中正确类型保存独立卡片。

原书依据 · 1 处

15.6 创建、插入和删除节点

节点工厂和插入接口将创建与加入文档分开,动态脚本示例在前文已作为主位置。

动态插入脚本也会执行关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

15.6.1 创建节点

工厂创建、深浅克隆和跨文档导入不同;新节点与已插入节点也不同。

创建节点后还需选择插入位置

createElement、createTextNode等工厂创建不同类型节点,创建并不等于已经加入页面。带命名空间的元素应明确URI和名称,不能只靠标签字符串猜语义。新节点可先设置属性或内容,再在合适位置插入;构造文本节点会保留文本数据含义,不能与把相同字符串作为HTML解析混为一谈。

创建节点后还需选择插入位置保存独立卡片。

原书依据 · 5 处
深克隆结构不等于复制所有状态

cloneNode返回新节点,deep=true递归复制后代,false只复制该节点的相应结构;深度是节点子树范围,不是任意JavaScript对象图复制。不能据此假设所有事件监听、外部引用或运行状态都已复制,重复id也需处理。importNode则为目标文档导入副本,不能与移动原节点混淆;是否需要复制应取决于对象身份和所属文档契约。

深克隆结构不等于复制所有状态保存独立卡片。

原书依据 · 4 处

15.6.2 插入节点

插入已有节点会移动身份而非自动复制,排序例先取静态列表;比较值与查询范围仍可能有缺陷。

闭包捕获的是活动作用域链而非快照关联本项背景,实质主要讲解在对应位置。

原书依据 · 7 处
插入已有节点会移动它

appendChild把节点放在父节点末尾,insertBefore在指定直接子节点前插入,参考节点为null时追加。传入已有节点会移动它,保留节点身份而非自动生成副本,所以用它重排行无需先删除再复制。位置仍须满足树的有效性要求,不能往任意对象或形成循环的位置插入;按索引的封装还要核对整数及边界。

插入已有节点会移动它保存独立卡片。

原书依据 · 3 处
表格排序先固定目标与比较契约

排序例先把实时行集合转成静态数组,比较后再移动原行,避免重排时改变正在遍历的集合。但后代标签查询可能包含嵌套表格的行与单元格,缺失td或th单元格也要考虑。默认按文本字典顺序比较,数字或日期需明确转换;textContent||innerText又会把有效空串当回退信号。先确认行范围、列和值类型,再谈排序结果正确。

表格排序先固定目标与比较契约保存独立卡片。

原书依据 · 2 处

15.6.3 删除和替换节点

删除替换在父节点上完成,原节点可继续存在并被包入新容器;旧outerHTML垫片不覆盖所有解析上下文。

删除替换在父节点上执行

removeChild由父节点接收要移除的直接子节点,replaceChild先新后旧;引用n本身不会因移除就消失。embolden先以b替换n,再把原n移进b,因此保留原节点身份,和复制文字不一样。调用前需确认查询命中且有合适父节点,否则n.parentNode链不能直接使用;原节点离开文档不等于一切关联自动清理。

删除替换在父节点上执行保存独立卡片。

原书依据 · 2 处
通用解析容器不能覆盖所有上下文

旧outerHTML垫片把字符串放进临时div解析,再把其子节点移到目标前,最后删除目标。这说明一种组合实现,但div解析与原目标的表格、命名空间等上下文不必等价,缺少父节点时也会失败。getter通过深克隆再序列化,不是返回原始源码文本。兼容层应说明支持范围和失败契约,不能由普通div例子成功推断完整原生等价。

通用解析容器不能覆盖所有上下文保存独立卡片。

原书依据 · 1 处

15.6.4 使用DocumentFragment

DocumentFragment暂存多个子节点,插入时移动的是子节点;insertAdjacentHTML垫片还需保留非法位置失败语义。

片段插入会移走其子节点

DocumentFragment可暂存多个节点;把它交给相应插入操作时,移动的是它的子节点,片段自身不成为普通父节点留在文档树中,随后片段变空。reverse例不断把原末子节点移到片段,再整体移回,于是反转所有子节点,包括文本和注释,而不只元素。片段是组合工具,不能据一次调用就保证事务回滚或任意场景性能必胜。

片段插入会移走其子节点保存独立卡片。

原书依据 · 3 处
插入垫片还要保留失败契约

Insert封装用四个位置名称映射到before/after/atStart/atEnd,辅助fragment用div解析并转移子节点。它继承了通用div解析的上下文限制;switch对未知位置没有报错分支,不能仅因已知四值可用就声称完整复刻原生API。元素外侧插入还需要合适父节点,HTML输入同样要考虑信任边界,静默不插入不应被误判为成功。

插入垫片还要保留失败契约保存独立卡片。

原书依据 · 1 处

15.7 例子:生成目录表

目录生成把就绪、选标题、编号、改标题、建锚点与添加入口串联,需区分算法骨架和重复运行/嵌套标记边界。

目录生成串联查询与结构修改

目录例先取得容器和标题列表,再按标题级别递增计数、清零更低层级,生成编号并建立链接。编号跟随实际标题层次,跳级时可能出现0前缀,是否允许应由文档规则决定。生成目录不是仅列字符串,它会改原标题、添加锚点和目录项,需要明确运行时机和对文档结构的影响。

结构图:本例处理流程,节点描述为操作而非类。

flowchart TD
  A[文档就绪回调] --> B[取得或创建目录容器]
  B --> C[选取标题列表]
  C --> D{还有标题吗}
  D -->|有| E[确定层级与过滤条件]
  E --> F[递增本级并清零低级计数]
  F --> G[插入编号并建立锚点]
  G --> H[创建目录链接并追加]
  H --> D
  D -->|无| I[本次生成结束]

目录生成串联查询与结构修改保存独立卡片。

原书依据 · 1 处

生成器应明确重复运行语义

本例只排除直接父节点是toc的标题,不能排除目录里更深的标题;把heading.innerHTML复制进链接也可能引入原有链接或其他交互标记。再次运行还会重复增加编号、包锚点和目录项,不是天然幂等。生产使用前应明确目录子树排除、标题标记处理、锚点唯一性与重建策略,不能把注释详尽当作这些边界已解决。

生成器应明确重复运行语义保存独立卡片。

原书依据 · 1 处

15.8 文档和元素的几何形状和滚动

布局视图在节点树之外增加位置与尺寸信息,定位工具提示等场景需要选对坐标和测量时机。

15.8.1 文档坐标和视口坐标

文档与视口原点不同,滚动偏移用于通常模型下的换算;辅助函数还存在目标窗口与尺寸分量错误。

坐标换算先确定原点

视口坐标从内容可见区域起算,文档坐标从相应文档基准起算;通常模型下,文档坐标等于视口坐标加滚动偏移。例如文档y=200、向下滚75时,视口y=125。测量、事件和定位必须采用一致基准,不能把屏幕坐标或浏览器外壳尺寸代入。固定定位、变换或布局变化等还会影响实际几何,不能把文档位置永不变当全局定律。

坐标换算先确定原点保存独立卡片。

原书依据 · 1 处
环境辅助函数别混用全局对象

getScrollOffsets与getViewportSize接收窗口w,却用当前document.compatMode选择分支,可能将一个文档的模式套给另一个文档。视口函数怪异分支还把高度写成d.body.clientWidth。返回值的x/y、w/h每项都要与所测对象和分量对应;支持多个窗口的封装不能只在部分分支使用传入参数。

环境辅助函数别混用全局对象保存独立卡片。

原书依据 · 1 处

15.8.2 查询元素的几何尺寸

边界矩形聚合元素的片段盒,返回测量快照;并非所有内联片段都填满外接矩形。

边界矩形可能包含空白区域

getBoundingClientRect给出当前视口坐标下的外接矩形,通常计入边框和内边距而不含外边距。跨行内联元素可有多个片段,外接矩形把它们包起来,内部不必每一点都属于元素内容,也不必总覆盖整行全宽。要了解各片段应看getClientRects,而不是用一个外接盒推断精确形状。

边界矩形可能包含空白区域保存独立卡片。

原书依据 · 3 处
几何测量结果不是实时视图

getBoundingClientRect和getClientRects返回调用时的几何结果,后续滚动、改尺寸或改变布局不会自动更新已保存对象。需要新位置时应在合适阶段重新测量,不能照搬实时DOM集合的更新直觉。转换文档坐标还应使用相应窗口当时的滚动偏移,避免混用不同时间或不同窗口的快照。

几何测量结果不是实时视图保存独立卡片。

原书依据 · 3 处

15.8.3 判定元素在某点

点命中查询使用视口坐标,返回的是可命中的元素,不是只看绘制层叠顺序的最上层色块。

点命中与视觉覆盖不完全相同

elementFromPoint(x,y)以视口坐标查询命中元素,视口外或无相应目标时可能返回null。当前CSSOM View说明pointer-events等可令最上方绘制元素不参与命中,所以不能简单等同最高z-index或最内层节点。事件target记录该次事件目标,当前点命中则是另一次查询,不能不看时机与分派语义就把二者永远当同一值。

点命中与视觉覆盖不完全相同保存独立卡片。

原书依据 · 1 处

15.8.4 滚动

scrollTo设目标偏移,scrollBy增加相对偏移,scrollIntoView围绕元素可见性;边界和用户体验仍需处理。

滚动目标与滚动增量分开

scrollTo或scroll设置目标滚动偏移,scrollBy增加相对偏移,实际结果受可滚动范围等条件限制。原书前文Window.scrollTop()是名称错误,scrollTop通常是元素滚动属性。为让某元素可见可用scrollIntoView,不必先手动算它的文档坐标;改变hash还涉及导航状态,不能把所有可见性操作视为完全等价。

滚动目标与滚动增量分开保存独立卡片。

原书依据 · 2 处
自动滚动需要保留停止入口

书签例每200毫秒滚动10像素,却没有保存interval句柄给调用方,缺少常规停止入口。自动持续移动会影响阅读和交互,应明确开始、暂停、停止及用户手动操作的关系。定时器只是安排下一次滚动请求,不保证匀速或精确节拍,也不能靠窗口滚到边界就认为定时工作已取消。

自动滚动需要保留停止入口保存独立卡片。

原书依据 · 2 处

15.8.5 关于元素尺寸、位置和溢出的更多信息

offset/client/scroll测量不同盒边界,偏移累加不是通用几何算法。

盒尺寸接口测量边界不同

offsetWidth/Height通常包含边框和内边距,clientWidth/Height排除边框与所占滚动条,scrollWidth/Height反映相应滚动内容范围。scrollLeft/Top是可读写偏移,offsetLeft/Top则相对offsetParent等规则。名称相近不能直接互换;根元素有特殊视口规则,行内与布局状态也会改变返回值,应按所需盒边界选接口。

盒尺寸接口测量边界不同保存独立卡片。

原书依据 · 1 处
偏移累加不是通用测量公式

累加offsetParent偏移再减祖先滚动,可说明位置由多层关系组合,但仍不足以完整覆盖边框、变换和特殊布局。offsetParent链也不是简单等同DOM父链,不应把算出一对数值就叫任何环境都正确。直接测量与手算应采用明确坐标和适用范围,不能宣称本例总与getBoundingClientRect相同;当前元素也已有scrollTo等接口,原书“没有”不是永久事实。

偏移累加不是通用测量公式保存独立卡片。

原书依据 · 1 处

15.9 HTML表单

表单原生收集与提交可独立于脚本,脚本增强可更细粒度响应用户操作;表中控件类型与返回值不同。

原生表单与脚本增强可协作

原生表单可收集数据并提交服务器,脚本可在单个控件交互时提供即时反馈,二者可组合而非互斥。表单不因没有鼠标可点的提交按钮就必然无用,隐式提交等路径也需考虑。表15-1列出的控件有不同类型、状态与事件,不应把隐藏域、文件选择和普通文本框都当作同一种字符串输入。

原生表单与脚本增强可协作保存独立卡片。

原书依据 · 1 处

15.9.1 选取表单和表单元素

表单可按元素查询,也可通过关联控件集合访问;名字冲突和同名组必须分辨。

命名元素不宜隐式当全局关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处
表单控件集合可能返回同名组

form.elements把控件访问与表单自身的method等成员分开,同名控件仍可能形成一组,而非单个Element。应检查结果形态并按checked等实际状态取值,不能把name当唯一id。原书把所有HTMLCollection同名都说成数组不够精确,应按具体集合接口判断;表单关联也不必只由DOM后代关系决定,外部控件可显式关联form。

表单控件集合可能返回同名组保存独立卡片。

原书依据 · 4 处

15.9.2 表单和元素的属性

表单属性与控件状态按具体接口解释;submit/reset的实际事件差异不能仅按相似名称推断。

控件值与所属表单按接口解释

value通常以字符串暴露控件值,但按钮文字、用户输入与单选项提交值的含义不同,不能一律当可见文本。form表示关联的表单或null,不仅是最近祖先;type和name也不能笼统称所有控件都只读。属性是否可写、改变后是否影响UI或提交,应按具体控件确认,而不是从通用清单机械推导。

控件值与所属表单按接口解释保存独立卡片。

原书依据 · 4 处

15.9.3 表单和元素的事件处理程序

提交、重置及控件变化具有不同触发路径,程序化调用不能一概视同点击按钮。

提交与重置事件路径不同

直接form.submit()绕过通常提交事件及相应约束验证路径,而用户提交、隐式提交或requestSubmit有另一条流程,不能把提交事件限制为鼠标点击。reset()则会走可取消的reset事件后再重置,原书声称直接调用不触发onreset有误。取消默认动作与恢复业务数据还需明确责任,服务端不能依赖客户端校验保证输入可信。

提交与重置事件路径不同保存独立卡片。

原书依据 · 2 处
变化事件与每次编辑不同

文本控件change通常在用户提交一次改动时触发,不等于每个键盘动作;focus/blur又表达焦点变化。应围绕任务选择编辑中反馈或完成后处理,不能把键盘事件当所有输入渠道。处理器中的this取决于注册方式与函数形式,原书“总是触发元素”也不能推广到箭头函数等所有回调;需要时应使用相应事件对象的明确字段。

变化事件与每次编辑不同保存独立卡片。

原书依据 · 3 处

15.9.4 按钮

按钮与链接表达不同任务,普通动作按钮必须明确type以免意外提交。

动作按钮应明确默认行为

若动作是导航到资源,链接能表达目标;执行页面动作则应用适合的按钮。input type=button与显式button type=button不自带提交,但不能把所有button元素都说成没有默认行为,表单内常规省略type的按钮可能提交。应明确type与所需默认动作,校验更适合围绕表单提交路径,避免只挂单个按钮而漏掉其他提交入口。

提交按钮可通过formAction/formMethod/formEnctype/formTarget覆盖关联表单的提交设置,formNoValidate是布尔开关。多个提交按钮可能走不同目标或验证策略,不能只看form本身;普通button/reset不据此触发表单提交。

动作按钮应明确默认行为保存独立卡片。

原书依据 · 3 处

15.9.5 开关按钮

checked当前状态、defaultChecked默认值与value提交值不同;单选互斥仍需看分组条件。

选中状态与提交值分开

checked表示当前是否选中,defaultChecked反映默认checked内容属性,两者不是同一个时刻的状态;默认值还可被脚本修改,不能理解成不可变首次快照。value表示对应选项提交的数据,不因改变它就修改旁边标签或切换checked。单选组的互斥还取决于同名和表单等分组条件,不能把页面上所有同名radio跨所有表单视为一组。

checkbox.indeterminate与checked独立,可同时存在;它主要表达不确定的外观,不替代实际checked提交状态,也不是HTML内容属性反映。defaultChecked/defaultValue供重置默认,改变当前状态不等于改默认。

选中状态与提交值分开保存独立卡片。

原书依据 · 4 处

15.9.6 文本域

文本值、提示、遮罩和文件选择各有边界,键盘过滤不能覆盖所有输入路径。

输入提示不等于字段实际值

placeholder显示输入提示,value表示实际控件值;两者不能互作默认业务数据。textarea同样用value读写当前多行输入,和其HTML初始文本有不同责任。change一般表达改动完成,不是实时每字输入;若按键过滤实现格式限制,还需考虑粘贴、输入法和程序化设置等其他入口,最终按业务规则验证真实值。

输入提示不等于字段实际值保存独立卡片。

原书依据 · 1 处
密码遮罩不提供传输加密

password输入的遮罩减少旁观者直接读屏,但底层值没有因此自动加密。传输保护需依赖合适的安全连接等机制,脚本访问、服务端保存与日志又各有责任,不能把看起来是星号当作端到端保密保证。原书说“修改了输入文本”应理解为显示遮罩,而不是实际密码值被改成星号。

密码遮罩不提供传输加密保存独立卡片。

原书依据 · 1 处
文件选择不能靠任意路径赋值

文件控件让用户明确选择待处理文件,脚本不能通过设置任意非空value强迫读取本机某路径。当前HTML允许赋空字符串清空选择,非空赋值会抛异常,因此原书笼统说只读不精确;显示的value也不是可信的真实完整文件路径。读取或上传应按实际选择和接口契约处理,不把文件名当成已经读取到文件内容。

文件选择不能靠任意路径赋值保存独立卡片。

原书依据 · 3 处

15.9.7 选择框和选项元素

select容纳option并维护选择状态,单一索引不足以表示多选,选项文字和提交值也不同。

多选状态不能用单个索引概括

selectedIndex返回首个选中项索引,无选中项为-1;多选时应查看各option.selected或相应选中集合,而不是只取一个索引就宣称掌握整组结果。select的multiple决定可多选,不是给只读type任意赋select-multiple。option.text表达显示文字,value表达提交或业务标识,改变一者不应被误解为另一个也必然同步改变。

多选状态不能用单个索引概括保存独立卡片。

原书依据 · 1 处
选项集合修改会改变文档

select.options提供与实际option节点相联的特殊集合接口;截断length、删除指定项或加入新Option会改变可选项,不只是修改一份普通数组副本。Option构造器区分text、value、defaultSelected和当前selected,默认与当前不能混用。也可用DOM节点接口增删;遍历同时删项仍须考虑索引移动与当前选择状态。

现行HTMLOptionsCollection继承普通HTMLCollection.namedItem的首匹配/无匹配null语义,不按旧参考重复名返回NodeList。remove(index)明确传索引,无效索引不应按原文猜删首项;length扩展创建空option,缩短会删真实节点,selectedIndex取首选中或-1。

选项集合修改会改变文档保存独立卡片。

原书依据 · 3 处

15.10 其他文档特性

最后一节汇集文档元信息、写入流和文本选区,它们不是同一个DOM内容接口。

15.10.1 Document的属性

来源地址可缺失且不构成身份认证,查询示例既有变量和拼接问题,又依赖旧搜索URL结构。

只读地址不等于首次快照关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处
来源地址不是可信身份凭据

document.referrer可能给出导航来源,也可能因没有来源或策略而为空,不能假设总有完整上页URL或搜索关键词。它是环境元信息,不是用户或请求可信身份的证明。基于它做提示应处理缺失与格式差异,不应用作权限控制;将其内容写入页面还需按实际文本或HTML上下文处理。

来源地址不是可信身份凭据保存独立卡片。

原书依据 · 1 处
来源查询示例有多层边界

示例用未定义的ref替代document.referrer来找问号,本地摘录的document.write调用还缺少闭合括号,不能原样视为可运行。它又依赖特定HTTP搜索地址、旧unescape以及只替换一次+,不符合通用查询解析契约;解码结果拼入HTML还有注入边界。应把来源识别、参数解析与安全呈现分成可检查的责任,不能因示例意图简单就跳过这些条件。

来源查询示例有多层边界保存独立卡片。

原书依据 · 1 处

15.10.2 document.write()方法

document.write关联解析输入流,迟调用可能重开文档;ElementStream只是全量缓冲到innerHTML的教学封装。

文档写入流不是普通追加接口

解析期间document.write可把文本加入解析输入流;在文档已结束等其他时机调用,可能隐式重开并替换文档,另一些上下文还会被忽略或限制。因此不能把它当事件回调里向页面末尾安全追加文字的通用方法。Document.close结束相应文档写序列,不是Window.close关窗口;writeln额外换行也不自动产生HTML可见换行。

文档写入流不是普通追加接口保存独立卡片。

原书依据 · 2 处
缓冲写入封装并非网络流

ElementStream构造函数保存目标元素和字符串buffer,write/writeln只拼接到内存,close一次把整个buffer设为innerHTML并清空。因此它不是逐块呈现或带背压的网络流,重复close还会用空buffer清空目标内容;目标不存在也没有防护。输入仍经HTML解析,未校验内容不能因包了一层API就变安全。

结构图:ElementStream为构造函数,图中类框表达实例通过原型可用的接口,不宣称源码使用class声明。write/writeln没有形参,通过arguments读取实参;返回值均为undefined。

classDiagram
  class ElementStreamInstance["ElementStream实例(原型接口)"] {
    elt
    buffer
    +write() undefined
    +writeln() undefined
    +close() undefined
  }
  class TargetElement["目标元素(示意)"] {
    innerHTML
  }
  ElementStreamInstance --> TargetElement : elt引用

缓冲写入封装并非网络流保存独立卡片。

原书依据 · 1 处

15.10.3 查询选取的文本

文档选区与表单控件内部选区需要不同入口,纯文本输出不能保留原始标记结构。

选区文本与表单内部选择分开

window.getSelection取得文档选区,转字符串得到选中的文本;文本控件可按自身value与selectionStart/End取子串。两种入口不能混为所有环境都自动覆盖一切选择,索引和可用性应按控件类型确认,未选择、无浏览上下文或不支持也需处理。字符串只保留文字,不保留完整节点或格式。

选区文本与表单内部选择分开保存独立卡片。

原书依据 · 3 处
选中文字进入地址仍需编码

选中文本书签把q拼入外部页面地址,展示从选区到导航的组合;这并不意味着任意文本都可直接作为合法路径。应按URL组件处理空值、特殊字符和目标构造,并考虑用户是否要把选中内容发送到外部站点。查询选区与发起导航是不同动作,不能因取得文字就自动推定已获后者许可。

选中文字进入地址仍需编码保存独立卡片。

原书依据 · 1 处

15.10.4 可编辑的内容

可编辑区域、整文档编辑和命令工具栏是不同层次;接口名称、状态查询及编辑结果的信任边界需明确。

可编辑区域不等于完整编辑器

HTML contenteditable可开启区域编辑,JavaScript反射属性的实际名称是contentEditable,isContentEditable则判断当前有效状态。它是有继承等状态的枚举属性,不应因空属性有效便当作普通布尔属性。designMode作用于文档,且访问iframe文档仍须满足权限。能输入富文本不等于已有一致的编辑模型、保存、撤销和净化策略,用户编辑出的HTML仍要按后续用途处理。

可编辑区域不等于完整编辑器保存独立卡片。

原书依据 · 2 处
编辑命令按支持与状态区分

历史execCommand在Document上根据选区或插入点执行命令,工具栏应分别考虑支持、当前可用、开关状态、关联值及不确定状态。正确查询名为queryCommandSupported与queryCommandIndeterm等,原书部分拼写不宜照抄;bold示例传入未定义url也不是必要的加粗参数。图中列出命令不证明所有环境行为一致,选型需明确所依赖接口与编辑结果契约。

编辑命令按支持与状态区分保存独立卡片。

原书依据 · 2 处

第16章 脚本化CSS

脚本可改局部内联声明、切换类或修改样式表,而读最终样式是另一项责任。

写入声明与查询结果分开

元素style主要表示内联声明,不包含样式表、继承和默认等所有来源共同形成的最终结果。脚本可以改声明、切换类或管理样式表,但要了解实际应用状态,应使用适合的计算/解析样式查询。不能因为style.color为空就认定元素没有颜色,也不能从写入一个声明直接推断它必定赢得层叠。

CSSStyleDeclaration的数字索引或item(i)给属性名,不是对应值,值需getPropertyValue(name)等读取;length是所含声明数量。内联/规则声明的可修改性与getComputedStyle只读结果不同。

写入声明与查询结果分开保存独立卡片。

原书依据 · 6 处

16.1 CSS概览

CSS声明与选择器规则组织呈现,外部样式用link关联;注释、单位和百分比基准不能按JavaScript直觉解释。

样式规则把条件与声明组合

样式规则由选择器和声明块组成,声明用属性名、冒号和值表达,多项用分号区分。多个页面可通过link rel=stylesheet复用外部CSS,不是给style添加src。CSS使用块注释,不能以JavaScript的//注释理解;百分比值也需看具体属性的参照,margin-left:10%不总等于页面宽度的十分之一。把内容和规则分开可减少重复,但仍需理解选择器如何命中。

样式规则把条件与声明组合保存独立卡片。

原书依据 · 1 处

16.1.1 层叠

层叠按每个属性选择声明,不能以单一“内联必胜”或“选择器越具体必胜”概括。

写入声明与查询结果分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处
层叠优先级不只看选择器

元素可能从默认、用户、作者及内联等来源取得声明,层叠对具体属性选择适用值。选择器具体度只在相应优先级条件下参与比较,不能把内联永远覆盖样式表或更具体永远胜出当通则;!important、来源及现代层等都会影响顺序。调试时应找出该属性有哪些声明以及胜出的理由,而不是只看最后写在哪个文件。

层叠优先级不只看选择器保存独立卡片。

原书依据 · 2 处

16.1.2 CSS历史

CSS从早期整体版本转向按模块推进,不同模块有各自成熟度与实现状态。

模块级别不等于全平台版本

CSS后续按专门模块分别推进规范,不应把“CSS3”理解成某一时刻所有浏览器共同完整实现的单一包。评估能力应具体到属性、语法、模块及目标环境,历史版本名只提供演化背景。原书的现代浏览器与旧IE支持描述属于当时状态,不能据它直接制定今天的兼容清单。

模块级别不等于全平台版本保存独立卡片。

原书依据 · 1 处

16.1.3 复合属性

复合属性一次涉及多个长属性,省略成员可能重置,不能仅按简写拼接理解。

复合声明可能重置未写子项

font、border、margin、padding等简写把一组相关属性放在同一声明中,但不等于只修改显式出现的子项。未指定的组成项可能回到初始值,因此在已有样式上局部调整时要核对影响范围。既可写边的组合属性,也可写某边颜色或宽度等长属性;应围绕要改动的责任选择,避免顺手覆盖其他设置。

复合声明可能重置未写子项保存独立卡片。

原书依据 · 1 处

16.1.4 非标准属性

厂商前缀记录实验和兼容阶段,不是永远需要为每个浏览器添加一份声明。

前缀兼容应有明确支持范围

厂商前缀常见于实验或历史实现,支持标准属性后可使用对应无前缀形式。兼容代码应围绕实际目标环境保留必要变体,而不是无条件复制所有前缀;不同名字也不能自动证明行为完全一致。把圆角等样式集中在类里可统一应用,但原书radius10的前缀列表是当时实例,不是当前必备模板。

前缀兼容应有明确支持范围保存独立卡片。

原书依据 · 1 处

16.1.5 CSS举例

样式例将标签、类、后代和id规则组合,图像展示实际视觉层次;前沿技术描述需按出版年代理解。

选择规则组合形成呈现结果

本例标题规则提供蓝色斜体,WARNING类提供粗字、黄底红边和留白,后代标题规则再让警告标题居中;id规则让另一个段落居中并以大写呈现。图16-1同时展示这些效果与内联覆盖的非大写行,说明一个元素的结果可由多个规则及继承组合。text-transform改变呈现,不意味着DOM文本数据本身已被改写成大写。

选择规则组合形成呈现结果保存独立卡片。

原书依据 · 1 处

16.2 重要的CSS属性

重要样式表覆盖定位、尺寸、可见性、裁剪、溢出和透明度,具体边界在后续正文。

16.2.1 用CSS定位元素

定位方案、包含块、尺寸单位与堆叠上下文需要分别理解,书中简化模型有边界。

定位参照不只由父元素决定

relative保留正常流位置并做偏移,absolute与fixed通常脱离正常流,但它们的参照是相应包含块而不一定是DOM父元素。常见relative容器可为绝对定位后代建立参照,现代transform等属性也会影响包含块;fixed也并非任何情况下都无条件相对视口。判断位置应先确认包含块及布局规则,不把所有left/top都当文档坐标。

定位参照不只由父元素决定保存独立卡片。

原书依据 · 2 处
定位尺寸要核对约束与单位

同时指定两侧偏移和宽高,会进入具体约束求解,不能用“width永远覆盖right”替代所有书写方向和盒条件。百分比依属性和包含块计算,单位也各有基准:em通常按字体大小而非行高,原书把两者混为一谈。要让元素居中或贴边,先明确其盒尺寸与参照,不能仅凭25%+50%的内容尺寸忽略边框和内边距。

定位尺寸要核对约束与单位保存独立卡片。

原书依据 · 1 处
堆叠顺序按上下文比较

z-index的初始值是auto,不能统一当显式0。层叠比较发生在堆叠上下文中,上下文作为整体参与其父级排序;更深后代写巨大数字也不必越过另一个上下文。它不是只对DOM兄弟生效,非定位内容也并非保证永远不重叠。应先找到限制元素的上下文再判断顺序,不能靠把数字不断加大解决。

堆叠顺序按上下文比较保存独立卡片。

原书依据 · 1 处
文字阴影不应复制业务内容

本例用相对容器、偏移的重复文本与堆叠顺序模拟阴影,展示定位组合的原理,但重复节点还可能影响选择、辅助读取与内容维护。若只需视觉阴影,应考虑表达该视觉效果的样式能力,不能把重复业务文本当作没有其他代价的等价替代。示例只是历史机制演示,未证明两种方案所有行为一致。

文字阴影不应复制业务内容保存独立卡片。

原书依据 · 1 处

16.2.2 边框、外边距和内边距

margin在边框外,padding在边框内,四值简写按顺时针;不因没有边框或脱离流就必然无意义。

内外边距承担不同空间责任

padding分隔内容和盒边缘,margin作用于盒外关系,四值简写按上右下左解释。没有可见边框仍可需要padding维持内容与背景边缘距离;绝对定位元素的margin也会参与其布局,不能沿用原书“无关要旨”的绝对说法。选择空间属性应看它属于盒内还是盒外,以及具体格式化规则,而不是仅看有没有画出边框。

内外边距承担不同空间责任保存独立卡片。

原书依据 · 1 处

16.2.3 CSS盒模型和定位细节

盒模型决定width/height包含哪些区域,定位参照也须考虑容器padding边界和子元素margin等条件。

盒尺寸必须说明包含哪些边界

content-box下显式宽高通常指定内容盒,边框和内边距另计;border-box下相应尺寸包含边框与内边距,但不包含margin。图16-2区分容器边框、padding和内容区域,以及子盒的定位参照。百分比总体宽度配固定边框padding时,先选清楚盒模型,不能把不同接口返回的宽度直接相加比较。

盒尺寸必须说明包含哪些边界保存独立卡片。

原书依据 · 1 处
定位示意图需要保留前提

本图用特定定位容器说明left/top常从相应包含块的padding边界度量,而不是从内容边界起算。例中容器padding=10时,想对齐内容区域就要考虑这段偏移;但图未画margin不等于绝对定位永远不受margin影响。真实布局还要确定包含块、盒模型及尺寸限制,不能把图中单一几何关系推广到任意变换与布局模式。

定位示意图需要保留前提保存独立卡片。

原书依据 · 1 处

16.2.4 元素显示和可见性

visibility隐藏盒但仍有布局,display:none抑制生成;即使脱离流也不代表二者完全等价。

隐藏呈现与移除布局不同

visibility:hidden通常保留盒的布局影响,display:none抑制相应盒生成,二者对布局、后代和交互有不同结果。即使目标为absolute或fixed,也不能因此宣布完全等价;可见后代等还受各自规则影响。选择隐藏方式应依据是否保留空间、是否可操作及用户获取信息的路径,不能把样式隐藏当数据删除或权限隔离。

隐藏呈现与移除布局不同保存独立卡片。

原书依据 · 1 处

16.2.5 颜色、透明度和半透明度

颜色分量透明度与整个元素opacity不是同一种效果,透明背景也不表示元素不能交互。

颜色透明度与整体透明度分开

带alpha的颜色可只作用于某个颜色声明,opacity则对元素及内容整体合成后的结果生效,不能用子节点再设1简单恢复被父级整体降低的不透明度。透明背景让下方内容透出,opacity=0也不自动移除布局或点击目标;呈现、布局和交互应分别控制。原书旧IE filter只作历史替代方案,不是当前跨浏览器必备代码。

颜色透明度与整体透明度分开保存独立卡片。

原书依据 · 1 处
颜色模型名称需准确区分

RGB按红绿蓝分量表达颜色,HSL中的L是亮度维度lightness,不是HSV的value;alpha再描述透明程度。十六进制三位简写按各位重复扩展,不是把每一位直接当0到15强度使用。选择色彩表示还需按任务理解亮暗和合成,不能把一种模型分量的算术操作等同所有模型的相同视觉效果。

颜色模型名称需准确区分保存独立卡片。

原书依据 · 2 处

16.2.6 部分可见:overflow和clip

overflow控制溢出呈现和滚动,旧clip定义局部裁剪边界,二者不是删除内容。

溢出处理不等于删除内容

overflow的visible、hidden、scroll、auto表达不同溢出与滚动策略,隐藏超出的绘制不等于移除节点或删除数据。hidden也不能简单解释成所有方式都无法滚动,实际还需看滚动容器规则。滚动条是否占空间及平台显示方式也有条件;界面应保证重要内容仍有合适访问入口,而不是只看到裁剪效果。

溢出处理不等于删除内容保存独立卡片。

原书依据 · 1 处
旧裁剪矩形按边界解释

旧clip的rect参数表达相对盒基准的四条边界,不是直接给出宽高,单位与auto要按其语法处理;裁剪也不改变原节点结构。它有适用元素等限制,不能作为任意形状与所有元素的通用裁剪方案。原书未带逗号的历史写法不应升级为逗号一概禁止,现代裁剪需求还应区分其他接口的契约。

旧裁剪矩形按边界解释保存独立卡片。

原书依据 · 1 处

16.2.7 示例:重叠半透明窗口

CSS可模拟重叠窗口外观,示例没有拖拽或关闭逻辑;固定尺寸跨规则重复带来维护成本。

窗口外观不等于窗口交互

window/titlebar/content类把普通div排成有标题和滚动内容的面板,半透明内容让后方面板透出。图16-3展示样式组合,并未创建真正浏览器窗口,也未实现拖拽、调整大小或关闭。视觉控件若要可操作还需补足行为、焦点与状态契约,不能因看起来像窗口就假定具备相同能力。

窗口外观不等于窗口交互保存独立卡片。

原书依据 · 1 处
重复尺寸常量增加联动成本

容器、标题栏与内容区分别硬编码尺寸,改总宽高时要同步考虑padding、border与偏移,多处常量容易失配。维护时应明确哪些尺寸由内容或约束关系导出,哪些需要统一参数,不能只把原手算公式原样搬进脚本就认为布局已易维护。该示例用于理解盒模型,不能代替完整弹性布局设计。

重复尺寸常量增加联动成本保存独立卡片。

原书依据 · 1 处

16.3 脚本化内联样式

style是声明接口,正确拼接CSS值需要名称、单位、分隔符和影响范围;读取内联空串不表示实际无样式。

层叠优先级不只看选择器关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

样式赋值需要有效语法

通常可用驼峰名字访问style的CSS属性,值仍须满足对应CSS语法。left的非零长度需带px等单位,四值margin还需要空白分隔;本地原始HTML示例直接拼出多个px值而无空格,不能当有效四值声明。并非所有属性都要长度单位,opacity等无量纲值及auto等关键字又有不同规则,不能统一追加px。

样式赋值需要有效语法保存独立卡片。

原书依据 · 2 处

整串样式更新有覆盖范围

cssText或style内容属性可一次设置一组内联声明,但赋整串会替换原内联声明范围,不自动保留未列出的旧设置。按单项修改与按整串替换适合不同责任;要临时改变后恢复,还需考虑其间别的代码更新。读取内联值只能说明这份声明本身,不能代替实际层叠结果或几何测量。

整串样式更新有覆盖范围保存独立卡片。

原书依据 · 1 处

CSS动画

动画例按耗时比例生成样式,再调度下一步;回调串联、取消与样式恢复是不同责任。

自动滚动需要保留停止入口关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处
动画进度按耗时而非帧数

shake与fadeOut每次重新计算已耗时间占总时长比例,据此求位置或透明度,再安排后续调用。这样比只累加帧数更能表达时间进度,但25毫秒只是调度意图,不保证40帧或精确完成时刻。时间参数、零值默认与异常输入也需明确;Date墙钟还可能调整,不能把示例当所有动画的时钟与调度最佳实践。

动画进度按耗时而非帧数保存独立卡片。

原书依据 · 1 处
动画结束不等于完整生命周期

shake完成时恢复先前整串cssText,再把元素传给回调,fadeOut可据此串联;但恢复也可能覆盖动画期间其他代码改的样式。两例未提供取消和重复启动协调,fadeOut设opacity=0也没有自动移除布局与交互。生产动画应明确开始、完成、取消、竞争写入与最终状态,不能只有视觉结束分支。

动画结束不等于完整生命周期保存独立卡片。

原书依据 · 1 处

16.4 查询计算出的样式

getComputedStyle查询只读解析样式,仍可能有关键字、列表和不同序列化形式,不能用简易数值正则处理所有值。

写入声明与查询结果分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

解析样式不保证全是像素数

getComputedStyle综合适用声明返回只读解析样式,某些值仍是auto、normal或字体列表,不能假设所有属性都转成px数或能反映最终使用的单一字体。当前pseudoElt参数可省略,cssText为空而不是原文说的未定义;尺寸定位若需要实际盒几何,应另用测量接口。只读也不等于静态快照,当前规范返回的是实时样式视图。

解析样式不保证全是像素数保存独立卡片。

原书依据 · 2 处

样式缩放要限制解析前提

scale用parseInt读取字体大小会截去小数,比例还需校验;scaleColor只按早期rgb/rgba数字形式匹配分量并缩放前三项,不适合现代所有色彩序列化和空间。把分量乘系数也不是感知上均匀提亮,保留alpha不表示结果一定可读。应明确接受的格式与单位,再处理无效值,不能把正则提数当完整CSS解析器。

样式缩放要限制解析前提保存独立卡片。

原书依据 · 1 处

16.5 脚本化CSS类

classList按token增删避免覆盖其他类,旧模拟实现既有空字符串错误,也有正则边界与实时性差异。

类名集合操作避免整串覆盖

直接把className设为attention或空串,会覆盖元素原有的其他类;classList以token为单位contains/add/remove/toggle,可更明确表达局部状态变化。它与className实时双向关联,不能把只读classList引用理解成类集合不可修改。类名影响哪些样式仍由层叠和选择器决定,新增一个类不保证每个声明必然胜出。

DOMTokenList.toggle(token)返回操作后该记号是否存在;现代可用force指定目标状态,true不一定表示这次真的新增。add/remove对单个token不接受空串或含ASCII空白,item越界为null而直接索引越界通常undefined。整体value是字符串表示,不等于变量本身被原地改成字符串。

类名集合操作避免整串覆盖保存独立卡片。

原书依据 · 5 处

类名不是正则单词集合

本地原始HTML中的contains/remove写c.indexOf(“”)!=-1,对任何字符串均成立,导致有效类名也抛错;add拼接处的空格同样丢失。即使补空格,使用未转义类名拼正则、以\b作为类边界及toArray的\w分词,也不能正确覆盖带连字符、元字符等合法类名。兼容对象不具备原生全部集合形态,不能只因方法同名就当等价。

类名不是正则单词集合保存独立卡片。

原书依据 · 1 处

集合适配要说明接口差异

classList(e)有原生入口时直接返回,否则新建CSSClassList实例保存元素引用;模拟对象可执行部分集合方法,另提供toArray快照,不是原生索引集合。toggle返回操作后是否包含,而不是指示调用方应否提前返回。

结构图:CSSClassList是构造函数,类框表示实例通过原型使用的接口;含有本地示例缺陷,图不表示实现已可运行。

classDiagram
  class CSSClassListInstance["CSSClassList实例(原型接口)"] {
    e
    +contains(c) boolean
    +add(c) undefined
    +remove(c) undefined
    +toggle(c) boolean
    +toString() string
    +toArray() Array
  }
  class ClassElement["目标元素(示意)"] {
    className
    classList
  }
  CSSClassListInstance --> ClassElement : e引用

集合适配要说明接口差异保存独立卡片。

原书依据 · 1 处

16.6 脚本化样式表

样式元素是DOM载体,CSSStyleSheet是样式表对象,不能把它们当同一对象。

样式载体与规则对象分开

style或link是文档元素,CSSStyleSheet表示其关联的样式规则,document.styleSheets提供文档关联表集合。查询DOM元素、管理加载载体和修改规则是不同层操作,不能把一个元素引用直接当成cssRules列表。修改前应确认表已存在及访问条件,标题元信息也不意味着其中内容被复制到DOM属性中。

样式载体与规则对象分开保存独立卡片。

原书依据 · 3 处

16.6.1 开启和关闭样式表

disabled控制样式表参与,选择器分支须限定正确载体,索引分支须确认范围。

样式表启停要确认操作对象

通过样式表相应disabled状态可以让规则暂不参与,但不等于从DOM删除内容或抹去表对象。示例接受数值索引或选择器,两种入口都需检查范围和结果类型;给任意选中的普通元素设置同名属性,不会自动将它变成可禁用样式表。恢复时还应明确之前状态,不能假设所有目标原本都开启。

样式表启停要确认操作对象保存独立卡片。

原书依据 · 3 处

16.6.2 查询、插入与删除样式表规则

规则有不同类型,选择器、声明与整条规则文本分开;实时增删还影响迭代索引。

规则选择器与声明文本分开

样式规则的selectorText表示选择器,style表示声明块,style.cssText只给声明文本而非完整规则。CSSRule还涵盖import等其他规则,不能对每项都假设有style和selectorText;原文selectText拼写与把它直接当声明对象的叙述不准确。按类型和所需操作选入口,避免把声明文本当整表或完整规则序列化。

规则选择器与声明文本分开保存独立卡片。

原书依据 · 2 处
规则增删会改变遍历边界

cssRules是关联规则列表,删除当前项后后项前移,因此示例回退i避免跳项;追加规则也会改变length,应明确是否处理本轮新加项。insertRule接收完整规则及位置,不代表其中每条声明都有效:例中text-weight应为font-weight,无效属性可能被忽略。成功插入一条规则与得到预期视觉结果是不同验收,不能只看调用未抛错。

规则增删会改变遍历边界保存独立卡片。

原书依据 · 2 处

16.6.3 创建新样式表

新样式表可通过载体创建,规则对象分支也要检查枚举与作用域;文档全局末项不等于刚创建的表。

创建样式表别依赖全局末项

addStyles先建style再取document.styleSheets最后一项,隐含创建与全局列表顺序的假设;维护时应保持明确的载体和关联表引用,并处理不存在或加载/访问限制。字符串分支与规则字典分支有不同解析契约,不能把对象任意可枚举属性都当可信CSS。此封装只是组合例,不自动提供输入校验、原子失败或完整错误处理。

创建样式表别依赖全局末项保存独立卡片。

原书依据 · 1 处
规则字典循环需要局部绑定

本例selector未声明,非严格模式可能污染全局,严格模式则可能失败;for-in还会枚举继承成员,不能当成仅有自有规则。对象键作为选择器、值作为声明文本,仍须保持CSS语法与信任边界。应明确字典结构和作用域,让创建规则的业务结果决定后续处理,而不是靠隐式全局变量承接循环。

规则字典循环需要局部绑定保存独立卡片。

原书依据 · 1 处

第17章 事件处理

事件发生、事件记录对象与监听函数要分开;传播、默认行为及回调执行也不是同一机制。

事件身份包含类型与目标关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

事件对象记录一次分派的信息

事件对象带有type、target及该类事件的附加信息,用于让处理器理解这一次分派。事件发生这一概念与Event实例可以区分,但不能由原书措辞推断现代代码不能创建或分派事件对象。原始目标、当前正在执行监听器的对象和监听函数是不同角色;传播到祖先也不表示事件在每层重新发生一次。

事件对象记录一次分派的信息保存独立卡片。

原书依据 · 3 处

17.1 事件类型

事件可按设备输入、语义交互、状态变化及特定API组织,分类帮助选入口而不保证触发时机一致。

交互入口优先表达用户任务

click可表达激活控件,不必来自鼠标,文本变化也不只由按键造成。选择监听入口应围绕用户任务和状态,而不是把键盘、触摸和鼠标强行视为一组等价物理动作。状态变化及专用API通知又有自己的字段与生命周期;分类用于理解契约,不能由都叫回调推断它们有相同传播和取消规则。

交互入口优先表达用户任务保存独立卡片。

原书依据 · 1 处

17.1.1 传统事件类型

传统事件涵盖表单、窗口、鼠标和键盘,既有共用字段,也有不同传播与默认行为。

变化事件与每次编辑不同关联本项背景,实质主要讲解在对应位置。

长任务阻塞主线程响应关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处
事件家族不能共用冒泡假设

focus/blur不冒泡而focusin/focusout可冒泡,mouseover/out与mouseenter/leave也有不同传播边界;不能因为同是鼠标或表单事件就一律按相同冒泡模型处理。relatedTarget帮助区分离开整个区域与仅转入子元素。监听容器前,应确认目标事件本身的传播契约,而不是只靠事件名字近似选择。

事件家族不能共用冒泡假设保存独立卡片。

原书依据 · 3 处
离开提示不能替代状态保存

unload通知与beforeunload离开确认是不同机制,不能用前者阻止导航,也不能把弹提示等同状态已持久化。当前浏览器决定确认文本,原书“返回字符串原样显示”不能沿用;是否出现提示也有策略条件。关键状态应有明确保存结果和失败处理,不应只在离开瞬间寄望同步弹窗完成全部业务。

离开提示不能替代状态保存保存独立卡片。

原书依据 · 3 处

17.1.2 DOM事件

DOM3草案概述中冒泡关系被反写,输入与键字段也混有历史提案,不宜当当前标准接口表。

事件家族不能共用冒泡假设关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处
历史输入事件提案需标版本

本书描述textinput/textInput、inputMethod以及KeyboardEvent.char等当时提案,不能因写在DOM3展望中就当作当前通用输入契约。现代文本编辑应区分物理按键和实际内容变化,具体选用的输入/组合事件及字段需依据目标规范和环境。wheel的delta也需结合其单位等信息解释,不能把数值直接一概当像素滚动量。

历史输入事件提案需标版本保存独立卡片。

原书依据 · 3 处

17.1.3 HTML5事件

新API事件既报告生命周期也需从目标状态读取细节,完成通知与成功结果分开。

生命周期完成不等于操作成功

I/O可用loadstart、progress及最终loadend等报告过程,load、error、abort又区分不同结果;只看到结束不能推断业务数据已成功取得。还应查看相应对象的状态、响应和错误契约,HTTP传输成功也不等于应用结果成功。跨API同名事件不能自动视为完全相同的状态机,应结合具体目标与操作判断。

生命周期完成不等于操作成功保存独立卡片。

原书依据 · 4 处
普通事件通知可配合目标状态

媒体等事件对象可能只提供通用事件信息,详细播放或缓冲状态需从对应目标对象读取。消息事件则有data、source、origin等字段,各类API的消息契约不同;不能把异步通知一律当成已经验证来源的可信结果。监听者要明确自己依赖哪项状态,并处理状态在后续变化的可能。

普通事件通知可配合目标状态保存独立卡片。

原书依据 · 1 处

17.1.4 触摸屏和移动设备事件

触摸可包含多个变化接触点,手势是更高层解释,不能把每次触摸都当鼠标移动。

触摸变化可能包含多个接触点

触摸事件可通过changedTouches等集合携带多个变化接触点,处理时须按各点身份与位置理解,不应固定取一个点就当完整手势。Safari历史gesture事件又把缩放和旋转作为高级结果,scale是相对初始距离的比值而不是像素距离;旋转角也不是坐标。多触点输入和单鼠标指针有不同状态模型,映射时应明确选择规则。

触摸变化可能包含多个接触点保存独立卡片。

原书依据 · 1 处
厂商手势不能当通用事件契约

本段讨论的是当时Apple移动Safari的触摸、gesture和方向接口,不能直接当所有移动设备的通用事件集合。原文srcoll应为scroll,方向事件名称先前写orientationchange而后变orientationchanged,需要核对实际接口,不能按后者造监听。屏幕旋转、窗口尺寸变化和用户手势也不是同一业务信号,应按任务选择。

厂商手势不能当通用事件契约保存独立卡片。

原书依据 · 1 处

17.2 注册事件处理程序

属性注册与监听器方法各有历史版本,先区分注册入口,再处理参数与调用语义。

17.2.1 设置JavaScript对象属性为事件处理程序

on属性只有一个当前回调槽,多模块直接覆盖可能冲突;不是目标上永远只能有一个监听器。

事件处理器由事件驱动调用关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

17.2.2 设置HTML标签属性为事件处理程序

HTML事件属性形成函数体并有附加名字环境,body上部分属性又实际转发到窗口。

事件属性具有两层语法关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处
标签处理器有附加名字环境

HTML事件属性被转换为带宿主名字查找规则的处理器,目标、表单和文档上的名称可能遮蔽全局入口。直接写open或location不总等于window.open或window.location,明确对象可减少冲突。部分写在body上的处理器还实际属于Window,不能只看标记位置判断调用对象;图中清单是历史接口范围,不是任意on属性都转发。

典型陷阱包括Document.open遮蔽窗口open、表单控件名location遮蔽Window.location;应使用window.open或window.location等明确对象引用。

标签处理器有附加名字环境保存独立卡片。

原书依据 · 2 处

17.2.3 addEventListener()

标准监听器可与on属性共存,去重与移除依据函数身份和捕获标志,不能宣称无条件依次全部执行。

属性式注册与监听器式注册的本质差异

onclick等处理器属性有一个当前回调槽,再次赋值替换该槽,而不表示目标对同一事件类型只能有一个处理程序。addEventListener可注册多个不同监听器,且可与属性处理器共存;以目标、类型、回调身份和capture等契约区分注册。同一类型/同一回调/同一capture重复添加不会新增一份,但stopImmediatePropagation、移除及传播规则等可能阻止后续调用,不能称各监听器永远互不干扰且必全执行。可复用模块通常应避免覆盖他人的on槽,并明确自己的注销和错误边界。

属性式注册与监听器式注册的本质差异保存独立卡片。

原书依据 · 2 处
监听器注销需要保留函数身份

移除监听器要匹配原目标、事件类型、同一回调对象及capture。重新写一个外观相同的匿名函数不是原函数,不能用于注销。捕获true/false是不同注册条件,现代options还可表达once、passive或signal,第三参也可省略;不能沿用旧浏览器要求将其固定为永远必须的布尔值。注册临时拖动监听器时,应同时设计结束和清理路径。

监听器注销需要保留函数身份保存独立卡片。

原书依据 · 4 处

17.2.4 attachEvent()

attachEvent属于旧IE事件模型,不只是名称不同,捕获、重复注册和调用上下文都需分别处理。

旧事件适配不只替换方法名

历史attachEvent/detachEvent使用带on的类型名、不提供同一捕获模型,还允许重复附加相同函数;不能把它当标准方法的简单别名。封装时应明确保留了哪些顺序、去重、this与取消语义,而不是提供同名addEvent便宣称跨环境完全一致。新项目不因书中降级示例就自动增加旧IE依赖。

旧事件适配不只替换方法名保存独立卡片。

原书依据 · 2 处

17.3 事件处理程序的调用

调用涉及事件参数、接收值、词法环境和返回语义,传播又决定哪些注册点被调用。

17.3.1 事件处理程序的参数

常规事件从参数读取对象,旧window.event是历史回退;全局错误处理特殊参数另按接口解释。

事件对象记录一次分派的信息关联本项背景,实质主要讲解在对应位置。

全局错误观察不等于恢复关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

17.3.2 事件处理程序的运行环境

普通函数监听器的this通常是当前注册目标,词法this或显式绑定另看规则;兼容包装还需保留注销身份。

监听器注销需要保留函数身份关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处
监听接收值不同于原始目标

以普通函数注册的DOM监听器通常以当前监听对象作为this,事件从子元素传播来时,this不必等于原始event.target,可结合currentTarget区分。箭头函数的词法this或绑定函数又有自身语义,不能把本书规则套给所有函数。旧attachEvent包装可用handler.call(target,event)调整普通回调接收值,但这只修复一项契约,不能顺带保证完整标准行为。

监听接收值不同于原始目标保存独立卡片。

原书依据 · 4 处

17.3.3 事件处理程序的作用域

函数监听器保留定义时词法环境,HTML处理器则有宿主附加名称规则,显式对象引用避免碰撞。

闭包捕获的是活动作用域链而非快照关联本项背景,实质主要讲解在对应位置。

标签处理器有附加名字环境关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

17.3.4 事件处理程序的返回值

处理器返回值是否影响默认动作取决于注册契约,不是任意回调return false都能取消事件。

离开提示不能替代状态保存关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处
返回假值不总能取消事件

传统事件处理器属性在相应可取消事件中通常可用返回false取消默认动作,但addEventListener回调的返回值不会据此取消,应使用事件对象的相应方法。Window onerror和beforeunload还有特殊规则,不能用一条return false概括全部回调。取消默认动作也不等于停止传播或业务失败,业务处理结果与宿主事件控制应分别表达。

返回假值不总能取消事件保存独立卡片。

原书依据 · 5 处

17.3.5 调用顺序

同一目标内的监听顺序与激活时机有关,on属性并非一律先于所有监听器。

属性处理器不保证最先执行

当前HTML将事件处理器槽纳入监听分派:其首次激活时的位置与前后addEventListener注册相关,不是on属性处理器永远先执行。更新已激活槽的函数与移除后重新激活也不完全相同;还需区分捕获和非捕获调用阶段。多模块行为应尽量通过明确状态契约协调,不要依赖原书的绝对优先规则或旧attachEvent的不定顺序。

属性处理器不保证最先执行保存独立卡片。

原书依据 · 1 处

17.3.6 事件传播

普通DOM路径上可用捕获、目标、冒泡理解分派,目标上的捕获监听会调用,冒泡是否继续由事件等条件决定。

事件传播的三阶段模型与事件委托

普通DOM事件路径可按捕获、目标和冒泡理解:祖先捕获监听先得到机会,目标上调用相应捕获及非捕获监听,事件允许冒泡且未被停止时再沿祖先向外。原书说目标上的捕获监听不会调用有误,元素load会冒泡的概括也不正确;路径还受特定事件和树边界等规则影响,不能说每次事件都完整走遍Window往返。事件委托在共同容器监听合适的可传播事件,再依据实际目标和边界分发,动态新增后代可复用容器监听,但嵌套目标、禁用状态与不冒泡事件仍需处理。

结构图:普通文档路径的简化流程;节点表示分派阶段而非节点类型继承,取消和树边界可提前改变流程。

flowchart TD
  A[祖先捕获监听由外向内] --> B[目标上的捕获监听]
  B --> C[目标上的非捕获监听]
  C --> D{允许继续冒泡吗}
  D -->|是| E[祖先非捕获监听由内向外]
  D -->|否| F[本次分派结束]
  E --> F

事件传播的三阶段模型与事件委托保存独立卡片。

原书依据 · 2 处

17.3.7 事件取消

默认取消、传播停止和立即停止是三项不同控制,取消还要满足事件及监听条件。

返回假值不总能取消事件关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处
阻止默认与停止传播分开

preventDefault尝试取消可取消事件的默认动作;stopPropagation停止后续路径传播但不自动取消默认动作,也不阻止当前对象同一轮剩余监听器;stopImmediatePropagation还会停止当前分派后续监听器。三者应按需要选择,不能因业务已处理就随手全部调用。cancelable与passive等条件影响默认取消是否生效,defaultPrevented反映取消标志,不是业务成功结果。

dispatchEvent同步执行分发,返回false表示可取消事件已被取消,否则true;它不汇总监听器的业务成功,不等待异步处理。监听器抛错的报告和调用方异常传播也有各自规则,不能把返回true当所有副作用成功。

阻止默认与停止传播分开保存独立卡片。

原书依据 · 4 处

17.4 文档加载事件

DOMContentLoaded比资源load更早满足DOM初始化需求,whenReady将回调队列聚合,但晚安装与异常路径仍有缺口。

文档就绪与资源完成不同关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

就绪队列要处理安装时机

whenReady监听就绪事件后设置内部ready,晚加入回调在ready已真时同步执行;它不同于前面onLoad以零延时异步补偿的契约。若整个辅助脚本在相关事件都过去后才安装,初始false可能一直得不到更新,需检查当前文档状态而不能只等待旧事件。回调应何时同步或异步也要对调用者明确,避免时序意外。

就绪队列要处理安装时机保存独立卡片。

原书依据 · 1 处

就绪回调队列需要失败策略

本例逐个调用funcs后才把ready设真并释放队列,回调再注册的函数也可能被本轮动态长度循环继续处理。但某回调抛错会中断后续调用且未到达完成赋值,重入还可能增加无界工作;并非天然一次且全员成功。队列封装应明确错误隔离、重入、清理与完成状态,不能把ready布尔仅当调用者短路开关而忽略实际执行结果。

就绪回调队列需要失败策略保存独立卡片。

原书依据 · 1 处

17.5 鼠标事件

拖动由开始时记录偏移、移动中更新和结束时清理组成;例子假定坐标参照简单,不能由绝对定位推出offsetParent必为body。

阻止默认与停止传播分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

拖动过程需要完整清理路径

drag在mousedown记录起点和偏移,临时监听mousemove与mouseup,移动时更新位置,结束时注销监听并在旧IE释放捕获。嵌套闭包保存这次拖动状态,说明生命周期不只有移动回调;标准分支还应考虑失焦、取消、重复启动等没有正常mouseup的结束情境。事件捕获帮助接收范围内通知,不等于无条件保证指针离开浏览环境后仍有所有事件。

拖动过程需要完整清理路径保存独立卡片。

原书依据 · 1 处

拖动坐标必须使用同一参照

示例把client坐标加页面滚动换成文档坐标,再与offsetLeft/Top相减;只有这些位置确实使用兼容参照时才成立。绝对定位不能保证offsetParent必为body,定位祖先、边框和嵌套滚动都可能改变计算。应先明确待拖元素的包含块与坐标转换,不把一个简单页面例子当通用拖动组件。

拖动坐标必须使用同一参照保存独立卡片。

原书依据 · 2 处

17.6 鼠标滚轮事件

滚轮数据带单位和设备差异,enclose教学例仍有拼写、双重扣减与边框测量错误,不能按旧缩放常量通用归一化。

滚轮增量先解释其单位

wheel的deltaX/Y/Z需结合deltaMode解释,可能按像素、行或页表达,不是固定乘-120就可与所有历史wheelDelta一致。硬件加速与平台行为也会改变增量;应围绕要实现的滚动或缩放任务定义转换,不能把旧Mac WebKit经验常量推广为通用归一化。取消默认滚动还受cancelable/passive等条件影响。

滚轮增量先解释其单位保存独立卡片。

原书依据 · 2 处

缩放边界要检查每个分量

enclose宽度分支把framewidth拼为framwidth,可能抛引用错误;高度先减deltaY后又在下限计算里再减一次,导致不对称更新。framewidth为border-box总宽,但平移范围需考虑实际内区,不能直接与内容外接宽度相减就保证无空白。字段、计量边界和每次增量应分别核对,不能凭画面能动就认定缩放正确。

缩放边界要检查每个分量保存独立卡片。

原书依据 · 1 处

兼容事件叠加可能重复处理

示例同时注册新旧滚轮事件并期待取消一个可抑制另一个,这只是兼容假设,不是所有环境保证。用Gecko子串识别Firefox也会受其他UA兼容文本影响;同一动作若进入多条路径可能被重复计量。适配层应选择明确事件与语义范围,保留注销入口,不能把额外监听数量当兼容性已增强的证据。

兼容事件叠加可能重复处理保存独立卡片。

原书依据 · 1 处

17.7 拖放事件

原生DnD在源与目标之间传输数据,不只是移动DOM坐标;格式、访问阶段、协商动作与成功后的清理分别负责。

文本节点保留消息的数据语义关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

拖放传数据不只是移动元素

原生拖放通过源、目标和DataTransfer交换带格式的数据,可跨应用进行;源可提供与屏幕所见不同的数据,时钟例显示时分却拖出完整时间戳。它与上一节单纯按鼠标改变left/top不同。源声明允许的动作,目标按理解的格式和自身能力接受,图标只表示反馈,不是业务载荷本身。

拖放传数据不只是移动元素保存独立卡片。

原书依据 · 2 处

拖放数据访问受阶段限制

拖放事件携带DataTransfer,但不表示每个阶段都能任意读写载荷。当前HTML在dragstart开放写入,drop提供读取,其他阶段通常可枚举格式而不能读取实际内容;原书说可在一般drag过程中修改数据不能直接沿用。代码应在正确阶段设置、检查与读取,不能用取到空字符串就判定用户一定拖了空数据。

结构图:本段接口协作视图,窗口图标不进入载荷模型;返回值按实际方法语义。

classDiagram
  class DragEventObject["DragEvent对象(示意)"] {
    dataTransfer
  }
  class DataTransferObject["DataTransfer接口视图"] {
    types
    files
    items
    effectAllowed
    dropEffect
    +setData(format, data) undefined
    +getData(format) string
    +setDragImage(image, x, y) undefined
  }
  DragEventObject --> DataTransferObject : dataTransfer引用

拖放数据访问受阶段限制保存独立卡片。

原书依据 · 3 处

接受拖放要匹配格式和动作

自定义目标先检查数据格式,再按需要取消dragover等默认拒绝行为并协商dropEffect,drop时读取和处理载荷。默认文本控件等另有规则,不能用“未取消dragenter就绝无后续事件”概括所有目标。浏览器协商copy/move/link也不证明服务器已保存数据;默认行为、界面反馈与业务接收应分别确认。

接受拖放要匹配格式和动作保存独立卡片。

原书依据 · 2 处

移动源数据需要确认实际结果

列表例先在目标用文本节点添加新项,再在源的dragend检查move才删除原项,说明移动需要结合实际结果而不是仅凭开始时允许move。dragend也会在取消结束时发生,不代表总成功。更复杂业务若包含持久化或异步失败,应保留源数据直到相应结果可靠,不能把视觉放下当提交已完成。

移动源数据需要确认实际结果保存独立卡片。

原书依据 · 1 处

嵌套拖放反馈需要状态一致

列表用relatedTarget或进入/离开计数判断是否真正离开容器,以免在子项间移动时反复清除高亮。但原样例类名拼接缺分隔,\bdnd\b也不是通用类token匹配;dragover无条件接受、空文本drop未统一复位、恢复整串原类还可能覆盖其他改动。反馈计数和样式状态应与接受结果统一维护,不能只处理有文本成功分支。

嵌套拖放反馈需要状态一致保存独立卡片。

原书依据 · 1 处

17.8 文本事件

输入前过滤、输入后观察和最终验证不同。旧事件适配及强制大写例还需输入法、选区和异常清理边界。

字符过滤不能替代完整值验证

例子逐个检查本次输入文本是否都在允许字符集合中,不等于验证整个字段的长度、范围或业务格式;逐UTF-16单元检查也不适合不加说明地推广到全部Unicode字符。粘贴、拖放和输入法不是单纯keypress,现代输入还应区分beforeinput、input与组合阶段,不能照搬旧textinput支持表。最终仍要验证实际完整值,服务端也不能信任只经过客户端过滤的数据。

字符过滤不能替代完整值验证保存独立卡片。

原书依据 · 1 处

输入前控制与输入后修正分开

输入前事件可在满足取消条件时阻止默认编辑,input则用于观察已发生变化,取消input不能回滚已插入内容。当前输入事件可能带data/inputType等,不能沿用原书永远不报告新内容的结论;数据字段还随编辑类型不同,不能假设每次都有单字符。强制大写会改业务文本,应考虑输入法进行中、光标与选区,而非只在每次通知后整串覆盖value。

输入前控制与输入后修正分开保存独立卡片。

原书依据 · 1 处

递归通知抑制需要异常恢复

旧propertychange适配在设置value前暂时清除自己的处理器,完成后恢复,以免属性变化再次触发自身。这说明内部修正可能形成通知反馈环;恢复和清理应覆盖异常路径,也不应无意覆盖其他模块处理器。此例只为旧IE兼容,不是当前通用输入监听方案;同一输入注册多种事件还需防重复处理。

递归通知抑制需要异常恢复保存独立卡片。

原书依据 · 1 处

17.9 键盘事件

快捷键把事件解析、规范化、查找和处理器结果关联起来,配置与事件必须共享命名契约;系统保留键与布局仍有限制。

返回假值不总能取消事件关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

快捷键不等于输入字符编码

键盘事件表达按键活动,不等于最终输入字符;现代key反映键含义,code标识物理位置,不能把旧keyCode一概视为按键字符Unicode编码。现代ArrowLeft、Delete、Escape和空格等值与本书Left、Del、Esc、Spacebar旧表不同。长按还可重复keydown,操作系统或浏览器保留组合可能根本不交给页面,应围绕任务和焦点设计快捷键,保留其他可操作入口。

快捷键不等于输入字符编码保存独立卡片。

原书依据 · 2 处

快捷键规范化必须两端一致

bind/unbind用normalize处理配置,但dispatch直接拼修饰键和小写key,没有同样应用别名规则;现代Escape和Delete等可与配置生成不同键。注释说非Mac把meta映射ctrl,实际normalize也未实现。排序、分隔符、大小写和别名需由同一个命名契约约束配置与事件两端,不能只规范化输入配置便认为一定匹配。

快捷键规范化必须两端一致保存独立卡片。

原书依据 · 1 处

快捷键绑定与监听安装分开

Keymap构造函数保存按键到处理器的map,bind/unbind改变映射,install另行注册keydown监听,dispatch决定是否调用业务处理器,并在其明确返回false时主动取消默认动作与传播。解绑一项并不等于卸载监听;本例install未返回清理函数,重复安装会有多个包装监听。构造器for(name in bindings)未声明name且可枚举继承属性,映射查找也应检查是否自有且可调用,不能把普通对象当无边界字典。

结构图:Keymap为构造函数,图展示实例原型接口与静态规范化函数;返回语义按代码。

classDiagram
  class KeymapInstance["Keymap实例(原型接口)"] {
    map
    +bind(key, func) undefined
    +unbind(key) undefined
    +install(element) undefined
    +dispatch(event, element) 处理器结果或undefined
  }
  class KeymapConstructor["Keymap构造函数(非实例类型)"] {
    aliases
    keyCodeToKeyName
    +normalize(keyid) string
  }
  class KeyboardTarget["事件目标(示意)"] {
    +addEventListener(type, handler, capture) undefined
  }
  KeymapInstance ..> KeymapConstructor : 使用静态规范化与映射
  KeymapInstance ..> KeyboardTarget : install注册keydown

快捷键绑定与监听安装分开保存独立卡片。

原书依据 · 1 处

第18章 脚本化HTTP

不重载页面的数据交换与长连接推送是不同通信模式;资源元素各有读回和执行边界。

局部数据更新不必整页重载关联本项背景,实质主要讲解在对应位置。

脚本来源不提供权限隔离关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

服务器推送仍需建立通信通道

Comet等模式让服务器在既有通道上延后或持续发送消息,但浏览器仍需先建立合适连接。长轮询在收到结果后再请求后续消息,不等于服务器能无条件主动连接任意客户端。连接关闭也不能单独证明应用已处理消息,可靠恢复、去重和确认需由具体协议定义;本章只介绍传输基础,不声称已给完整消息系统。

服务器推送仍需建立通信通道保存独立卡片。

原书依据 · 1 处

18.1 使用XMLHttpRequest

XHR在浏览器HTTP环境内管理请求状态,不是绕过cookie、缓存、代理和源规则的原始网络API。

请求对象复用会影响在途操作

XMLHttpRequest对象承载请求配置、状态与响应,重新open会终止该对象先前的相关活动,不能用一个实例同时表示多个互不影响的在途交换。并发业务应明确每次操作的实例和结果归属,不把后返回的数据自动应用到当前界面。旧ActiveX构造降级仅用于历史阅读,不能因曾可重用就忽略状态重置。

请求对象复用会影响在途操作保存独立卡片。

原书依据 · 2 处

浏览器HTTP接口不是裸连接

XHR让脚本配置方法、URL、部分头和主体并读取允许暴露的响应,浏览器仍处理cookie、重定向、缓存、代理及安全限制。这不意味着应用可忽略认证、缓存或跨源的业务影响,只是接口隐藏了部分底层细节。file页面的相对地址也不自动变成HTTP,本地开发应区分资源基准与服务器环境,不把双击文件当真实网络联调。

浏览器HTTP接口不是裸连接保存独立卡片。

原书依据 · 2 处

18.1.1 指定请求

先open后设头再send是接口状态契约;方法语义、缓存和浏览器管理头还需分别解释。

请求配置遵循接口状态顺序

正确顺序是open配置方法与地址,随后setRequestHeader,最后send发起;原文把设置头的前后条件反写。当前规范在未OPENED或已调用send时拒绝设置请求头,同名头通常追加合并而非简单覆盖。接口顺序来自状态契约,不是每次方法调用都已逐字写到网络;send返回也不证明服务器已接收或保存。

请求配置遵循接口状态顺序保存独立卡片。

原书依据 · 2 处
方法名称不自动保证业务语义

GET应遵守安全读取的语义,POST用于目标资源按其规则处理提交内容,但方法名不能证明服务端实现没有副作用或具备幂等。POST响应在明确条件下可缓存,不能一律说永不缓存;XHR会把GET/HEAD主体置空,这与笼统断言HTTP任何GET绝无主体不是同一层规则。应依据协议和业务契约选择,不能靠客户端方法名替代服务端正确性。

方法名称不自动保证业务语义保存独立卡片。

原书依据 · 1 处
HTTP头受浏览器接口约束

脚本只能通过接口设置允许的请求头,像Content-Length等由浏览器控制,不能把setRequestHeader当原始报文编辑器。图中列表是历史清单,现行Fetch已不把User-Agent列入同一禁止名单,但实现仍可能有自身限制;不要据此承诺任意浏览器一定可改。HTTP方法通常大小写敏感,XHR只对规定的常见方法规范化,原文所有方法均不区分大小写不准确。

HTTP头受浏览器接口约束保存独立卡片。

原书依据 · 2 处

18.1.2 取得响应

请求完成、HTTP成功与响应解析是三个层次,类型头可缺失且带参数,例子不是完整错误契约。

请求完成状态不代表成功

readyState从UNSENT、OPENED、HEADERS_RECEIVED、LOADING到DONE描述请求处理状态;DONE不是HTTP或业务成功的代名词。响应处理还需检查状态和预期内容,成功状态范围应按接口契约确定,不能只因样例只接200就认为201等都失败。失败、超时、取消、解析异常和回调归属都应有明确路径,静默不调用成功回调不等于完整错误处理。

请求完成状态不代表成功保存独立卡片。

原书依据 · 4 处
响应类型解析要处理空值和参数

Content-Type可能缺失,也可带charset等参数,直接type.match/indexOf可能抛错,严格等于application/json又可能漏掉合法带参数表示。文本前缀匹配不证明结构或业务格式正确,JSON.parse也可能失败。应先明确支持的MIME及响应类型,再解析并验证结果,不能把收到文本自动当作可信代码执行。

响应类型解析要处理空值和参数保存独立卡片。

原书依据 · 2 处
同步网络等待会阻塞执行

同步XHR把等待网络放进当前执行路径,慢响应会推迟同一线程的交互和后续工作,主窗口场景应避免把它当更简单的默认方案。异步API则在后续通知读取结果,但仍需完成、失败和取消契约,不能用一个回调省略所有状态。规范对窗口中的同步XHR已有明确限制与退场方向,本书所述旧Worker场景也不自动适合任意任务。

同步网络等待会阻塞执行保存独立卡片。

原书依据 · 1 处
响应解码不是任意字节转字符

responseText按文本解码,不能用charCodeAt恢复任意二进制字节;Document、JSON和二进制结果应按相应responseType及数据格式处理。overrideMimeType可影响解码,前提是正确了解资源与调用时机,不会修复损坏数据或绕过跨源权限。原文setOverrideMimeType是名称错误;现代二进制接口也不能因本书当时尚未实现便忽略。

响应解码不是任意字节转字符保存独立卡片。

原书依据 · 2 处

18.1.3 编码请求主体

请求主体格式由协议约定与Content-Type配合,手写编码、JSON/XML、文件与multipart各有边界。

闭包捕获的是活动作用域链而非快照关联本项背景,实质主要讲解在对应位置。

原书依据 · 7 处
表单编码顺序影响真实数据

application/x-www-form-urlencoded需分别编码名字和值,再按等号和&组装,表单空格转换也有明确顺序。本例在编码前替换字面%20且只替一次,会改坏本来包含%20的数据,又未按意图处理所有空格。null/undefined直接toString会失败,自有属性检查也可能被同名字段覆盖;对象数组和重复键更需契约。邮编应作为保留前导零的字符串,不能用旧八进制风格数字02134代替。

表单编码顺序影响真实数据保存独立卡片。

原书依据 · 1 处
查询拼接需要保留现有地址结构

getData直接在url后加问号,只适合已明确没有查询及片段等条件的地址;已有参数或hash时可能得到错误目标。将同一业务数据放到查询、路径或主体,需要服务端相应契约,而不是任意换一种字符串形状。HTML表单method缺省为GET,原书称默认POST有误;读取与写入的语义也不能由有没有表单决定。

查询拼接需要保留现有地址结构保存独立卡片。

原书依据 · 2 处
主体格式与类型声明要匹配

JSON.stringify生成JSON文本,XML Document则可由XHR序列化并选择合适类型,普通字符串、Blob和表单编码又有不同格式。Content-Type是解释约定,不会自动把任意对象变成该格式;序列化可失败或丢失不受支持数据,响应回调也仍需检查结果。原文ext/plain应为text/plain,JSON.parse是解码而不是编码,不应混淆方向。

主体格式与类型声明要匹配保存独立卡片。

原书依据 · 1 处
文件对象不等于任意本机路径

send可接收选定或生成的File/Blob作为主体,但这不意味着脚本凭一个路径就读到用户任意文件。现代File API已有File构造器,原书不存在构造器的说法是历史状态;构造器只组合已有数据,不授予文件系统路径读取权限。选择文件后自动上传仍是明确的产品行为,应确认目标与结果,不能把选择动作和成功上传混同。

文件对象不等于任意本机路径保存独立卡片。

原书依据 · 3 处
多部分主体让接口管理边界

FormData逐项保存名字和值或File/Blob,交给send时由相应提取过程生成multipart边界并配套Content-Type。不要仅手写multipart/form-data头却遗漏与主体一致的边界,也不要把它等同发送一个裸文件。输入字典的同名字段、非字符串值和失败结果仍应按任务处理,生成请求主体不等于服务端保存已完成。

多部分主体让接口管理边界保存独立卡片。

原书依据 · 1 处

18.1.4 HTTP进度事件

进度、上传完成和HTTP响应分别表示不同阶段,示例过早复位且没有失败清理。

生命周期完成不等于操作成功关联本项背景,实质主要讲解在对应位置。

输出上下文决定注入边界关联本项背景,实质主要讲解在对应位置。

闭包捕获的是活动作用域链而非快照关联本项背景,实质主要讲解在对应位置。

原书依据 · 14 处
上传完成不等于服务器成功

xhr.upload的进度和load关注请求体传输,不能证明服务器已处理完成或业务保存成功。例子在upload.onload就移除uploading状态并允许新上传,却不检查主xhr响应;上传失败、取消或超时还可能永不复位。应分别表示上传、等待响应和业务结果,并在所有终止路径清理,而不是把字节发完当最终成功。

上传完成不等于服务器成功保存独立卡片。

原书依据 · 1 处
进度百分比需要可计算总量

progress的loaded和total描述相应传输进度,只有总量可计算且分母有效时才适合展示百分比;否则应提供不定进度状态。快速请求可能没有中间progress通知,频率也不是精确计时保证。x.onprogress和x.upload.onprogress对应下载与上传,不能把一个百分比泛称整个业务完成度。

进度百分比需要可计算总量保存独立卡片。

原书依据 · 4 处

18.1.5 中止请求和超时

超时取消控制客户端等待,不能由abort推出服务器撤销;竞态回调和定时清理需要共同维护。

取消等待不等于撤销远端操作

abort适合停止不再相关的客户端请求,例如用户输入已变化后旧的推荐结果。它不保证服务端尚未处理或已回滚副作用;同样要防止旧回调覆盖新界面,明确结果所属操作。原生超时有timeout语义,手工定时abort则要维护自己的终止原因,不能把所有失败都记成同一种取消。

取消等待不等于撤销远端操作保存独立卡片。

原书依据 · 2 处
超时定时器也有生命周期

timedGetText用标志排除超时后的回调,并在正常终止分支清除timer,但open/send同步失败等路径也需清理,外部还没有取消句柄。请求完成、超时计时与回调可能竞争,终止状态应保证同一操作只结算一次,并按真实原因报告;不能仅设置timedout就认为全部资源与错误路径已收口。

超时定时器也有生命周期保存独立卡片。

原书依据 · 2 处

18.1.6 跨域HTTP请求

CORS授权响应共享,凭据与服务器响应条件分别负责;HEAD提示例还要使用正确监听目标。

跨源共享不等于解除所有隔离关联本项背景,实质主要讲解在对应位置。

监听接收值不同于原始目标关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处
跨源凭据配置不是授权证明

withCredentials表达XHR是否在跨源交换中使用相应凭据模式,不保证服务器授权共享,也不替代登录与业务权限。服务器响应还须满足CORS对应条件,cookie自身策略也另有作用;测试属性存在只说明接口线索,不能证明某资源可访问。原书跨源永不发送用户名密码等绝对说法不能代替当前具体认证与请求规则。

跨源凭据配置不是授权证明保存独立卡片。

原书依据 · 1 处
容器监听不要误用原始目标

链接mouseover可能从内部span等后代冒泡,直接把e.target当a读取href会失去正确URL;注销时还可能对错对象操作。应区分注册对象与原始目标,按正确链接取得配置并清理监听。HEAD返回的类型、大小和修改时间也可能缺失或受跨源暴露限制,工具提示不能把null或单次失败当资源完整事实。

容器监听不要误用原始目标保存独立卡片。

原书依据 · 1 处

18.2 借助<script>发送HTTP请求:JSONP

JSONP响应是可执行回调脚本而非任意JSON,独立回调名和finally清理仍未覆盖未回调失败。

查询拼接需要保留现有地址结构关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

回调包装数据仍是执行代码

JSONP要求服务器返回函数调用等JavaScript代码,以约定回调名交付数据,纯JSON本身不构成完整客户端交付协议。script加载执行使远端服务处于页面执行信任边界内,不能把JSONP等同JSON.parse或只读数据下载。CORS与JSONP的权限机制不同,不能因能跨源加载脚本就宣称绕过了所有浏览器策略。

回调包装数据仍是执行代码保存独立卡片。

原书依据 · 3 处

远端回调需要失败清理

getJSONP为每次请求建回调属性,正常回调以finally删除属性和script,即使业务回调抛错仍尝试清理,这是有价值的成功路径设计。但下载失败、返回内容未调用约定函数、超时或目标节点已被移除等仍需处理;只写finally不覆盖根本未进入回调的路径。回调命名与URL参数也须和服务协议匹配,不能默认所有服务都认jsonp字段。

远端回调需要失败清理保存独立卡片。

原书依据 · 1 处

18.3 基于服务器端推送事件的Comet技术

EventSource用文本事件流实现单向推送,命名事件、跨块解析、重连、生命周期和服务器写入均有独立契约。

文本节点保留消息的数据语义关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

事件流按类型分派完整消息

SSE用text/event-stream承载按行组织的字段,多行data以换行组合,并以空行形成可分派消息。默认类型是message,event字段可指定其他类型;命名事件应注册相应监听,而不是如原书所说onmessage接收所有类型再自行分派。图中bid与两行数据正展示这一点,字段文本是协议内容,不是JSON自动解析。

事件流按类型分派完整消息保存独立卡片。

原书依据 · 2 处

流式解析必须保留跨块状态

XHR响应分块不与协议行或消息边界对齐,不能对每次新chunk直接split后当作完整行处理。本例没有保留未完行和跨块CRLF,还可能抹去末尾分隔,故完整消息会因网络切块而被误读。应累计未完行,逐条完成字段解析,遇到完整空行才分派,并按协议重置消息缓冲;连接结束前未完成的事件不能凭猜测发送。

结构图:由原例缺口归纳的解析责任流程,表示应保留的状态,未冒充示例已正确实现或已运行。

flowchart TD
  A[接收新增文本块] --> B[拼接上次未完行]
  B --> C{能取得完整行吗}
  C -->|不能| D[保存余段等待下块]
  C -->|能| E{是空行吗}
  E -->|否| F[按字段更新消息缓冲]
  E -->|是| G[按协议分派并重置消息状态]
  F --> C
  G --> C

流式解析必须保留跨块状态保存独立卡片。

原书依据 · 1 处

协议字段解析不能靠近似规则

本地原始HTML把冒号后单空格判断写成空字符串,无法按协议去掉实际首空格;eventName分派后未复位,也会让后续默认消息继承旧类型。retry用parseInt再||1000会接受不纯数字前缀并丢失合法0,id也需遵守其字段规则。伪事件origin直接设url不是实际最终来源,不能拿它当通过验证的安全源标识。协议解析的每个字段都有可核对契约,不能只以普通文本例子代替。

协议字段解析不能靠近似规则保存独立卡片。

原书依据 · 1 处

重连需要关闭与恢复契约

模拟EventSource承认没有close、open/error事件和完整监听接口;重新连接也只做简单延时,没有完整资源取消、异常状态或服务器重放机制。记录lastEventId仅提供恢复线索,不自动实现服务器端持久化、去重和无丢失交付。使用长连接应明确主动停止、失败后策略与消息确认语义,而不是无限重连就宣称可靠。

重连需要关闭与恢复契约保存独立卡片。

原书依据 · 2 处

聊天发送与显示需要结果归属

客户端用POST发送消息,用EventSource订阅独立消息流,消息通过文本节点呈现;两条通道各有生命周期。发送后立即清空输入且忽略状态,可能在服务端失败时丢失待发送文字,收到广播也不能自动证明所有订阅者都处理成功。发送中、失败重试和已显示结果应有明确归属,示例匿名昵称更不是身份认证方案。

聊天发送与显示需要结果归属保存独立卡片。

原书依据 · 1 处

广播服务需要处理写入和断连

服务端保存响应对象并向所有订阅者写事件流,演示基本广播而非完整消息服务。本例只替换正文第一个换行、心跳写成字面:ping?n而无正确行结束,还未处理写入背压、断连错误和请求体大小。删除订阅者前也应确认indexOf结果,-1会删错最后对象;未声明message会混入全局。POST返回200与广播真正交付并非同一结果,不能把教学服务器视为已可靠上线。

广播服务需要处理写入和断连保存独立卡片。

原书依据 · 1 处

第19章 jQuery类库

本章围绕jQuery选择集合、批量操作与链式表达展开,所有具体API先标注1.4时代,不将当时流行度当当前选型依据。

集合操作把查询与批处理连接

jQuery以选择器取得包装集合,再用方法对匹配元素批量操作,减少逐元素循环样板。多数写操作返回包装集合以支持链式调用,但读取或变换方法有不同返回契约,不能把所有链条都当同一对象。该组织方式是本章理解重点;是否采用库仍需结合项目版本与需求,书中jQuery 1.4不是当前默认推荐版本。

集合操作把查询与批处理连接保存独立卡片。

原书依据 · 4 处

19.1 jQuery基础

jQuery函数与其返回的包装对象不同,链式写操作并不让原生元素变成库对象。

共享脚本缓存有命中条件关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

包装对象与原生元素不同

$或jQuery是查询/包装入口,返回的jQuery对象表示一组元素;它和集合里单个原生Element不同。可对包装对象调用css等库方法,事件回调中的原生this则通常需再包装才能使用这些方法。入口是工厂式API,不从调用外观推断源码使用class或必须new;链式调用也依赖每个方法实际返回值。

包装对象与原生元素不同保存独立卡片。

原书依据 · 2 处

19.1.1 jQuery()函数

重载入口按参数形态承担查询、包装、构造与就绪注册,不同形式有不同信任与时序。

重载入口先区分参数形态

jQuery 1.4入口可按选择器查询、包装原生对象或数组、由HTML字符串构造节点、注册DOM就绪函数。创建节点不自动插入文档,HTML字符串也不是普通文字;同一函数名不表示可以把任意不可信字符串随意交给它。可选上下文或初始化对象又影响查询范围和方法调用,应先确认调用形态再理解第二参数。

重载入口先区分参数形态保存独立卡片。

原书依据 · 2 处
局部别名减少全局名字竞争

noConflict让出$的全局名字后,仍可在就绪回调参数中把jQuery命名为局部$,使内部代码保留简短入口而不覆盖其他库。这是名字作用域管理,不是把页面不同库隔离到安全沙箱;多个版本与插件还需明确各自实例。书中晚注册就绪立即同步调用的时序属于所述版本,不能不查版本推广到所有后来实现。

局部别名减少全局名字竞争保存独立卡片。

原书依据 · 2 处
命名空间函数与实例方法分开

$.each等定义在jQuery函数命名空间中,$(“a”).each等则作用于一个包装集合。它们可能同名但输入对象、回调参数和返回值不同,不能看见each就当成同一种遍历。库文档的点号与美元符号约定用于表达这种归属,阅读调用时先确定接收者,避免把全局函数、包装结果和其中元素混淆。

命名空间函数与实例方法分开保存独立卡片。

原书依据 · 1 处

19.1.2 查询与查询结果

包装集合遍历、映射、索引和谓词各有返回契约;原书index方向与map类数组展平需校正。

集合遍历回调不等于数组遍历

jQuery each对集合元素调用普通回调时,以元素为this,并传索引与元素;返回false可中止遍历,而each自身返回原包装对象。它不同于原生forEach的参数与中止约定,也不表示回调中this就是jQuery对象。可直接批量调用的方法通常无需手动each;需要自定义每项操作时才明确使用回调。

集合遍历回调不等于数组遍历保存独立卡片。

原书依据 · 2 处
映射集合不保证一进一出

jQuery map把每次回调返回结果收集成新包装集合,null/undefined被略过,数组会被展平一层,因此输出数量未必等于输入。原书说所有类数组含jQuery对象都自动展平不准确,1.4.2官方源码使用concat,仅凭类数组形态不获得数组展平语义。结果还可能包含非DOM数据,不能继续假设每项都可操作样式。

映射集合不保证一进一出保存独立卡片。

原书依据 · 3 处
重载索引查询要认清搜索方向

index(element)在当前包装集合中找参数元素;index(selector)则到选择器匹配集合中找当前对象的首元素,不能把方向反过来。无参数版本返回首元素在兄弟元素中的位置,不是“第一个毗邻元素”的含混索引。未找到返回-1也与位置0不同,调用方应按具体重载解释。

重载索引查询要认清搜索方向保存独立卡片。

原书依据 · 2 处
集合谓词不等于逐项断言

is(selector)只需包装集合中至少一个元素匹配就可为true,并不证明所有元素匹配。同理,结果长度非零、某项具有类名与全体符合条件,是不同量词。需要全部满足时应明确按全体条件验证,不能从一个聚合集合布尔值推断每项状态。

集合谓词不等于逐项断言保存独立卡片。

原书依据 · 3 处

19.2 jQuery的getter和setter

集合getter与setter常用同名重载,返回值和批量范围按调用形态改变,但只是惯例非所有方法定律。

集合读写有不同返回类型

许多jQuery方法无新值时读取首元素某项状态,有新值时修改匹配元素并返回集合用于链式调用;对象或回调参数可批量生成设置值。于是链上某一步一旦转成字符串、数字或其他结果,下一步不能再按包装对象操作。具体方法仍有聚合文本、集合值等例外,应查其返回契约,不能把这一概要当所有API的统一定律。

集合读写有不同返回类型保存独立卡片。

原书依据 · 3 处

19.2.1 获取和设置HTML属性

attr在书中旧版混有对象属性语义,现代文档明确区分内容属性与prop,读写目标需按版本判断。

集合读写有不同返回类型关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处
旧属性接口需要版本前提

本书针对jQuery 1.4描述attr兼容命名与部分DOM属性,不能原样套给后续版本。官方文档说明1.6起prop用于明确DOM属性,attr关注内容属性;checked当前状态与默认标记本来就不同。迁移或维护时应先确定版本和所需状态,不能因旧例能用className/htmlFor就推断任何名字、任何版本都等价。

旧属性接口需要版本前提保存独立卡片。

原书依据 · 2 处

19.2.2 获取和设置CSS属性

css读取解析样式而写入内联声明,数值单位处理不能替代合法属性名和值。

写入声明与查询结果分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处
样式包装不修复错误属性名

css可接受连字符或相应驼峰名称,并对一些数值按规则添加单位,但不会把任意错误字段修成合法CSS。例中的textColor应对照color,font-variant值应是small-caps而非smallcaps;字体缩放用parseInt也丢失小数。应明确属性、值与库版本的转换规则,不能因方法支持对象批量写入就假定每项都成功生效。

样式包装不修复错误属性名保存独立卡片。

原书依据 · 2 处

19.2.3 获取和设置CSS类

类集合增删支持局部状态,hasClass是任一命中,不是代码注释声称的全体。

类名集合操作避免整串覆盖关联本项背景,实质主要讲解在对应位置。

集合谓词不等于逐项断言关联本项背景,实质主要讲解在对应位置。

原书依据 · 8 处

19.2.4 获取和设置HTML表单值

val按控件类型读写,复选框数组匹配值,不能把名字或当前选中状态混同。

表单值包装仍要看控件类型

val读取文本、单选select或多选select可返回不同形态,设置数组时可按值调整checkbox/radio或option的选中状态。1.4.2实现对复选/单选比较控件val,而非按name匹配,原注释“名字或值”不准确。读取一组radio也不自动筛选已选项,需要明确:checked等条件;给value赋值不代表用户交互或自动提交。

表单值包装仍要看控件类型保存独立卡片。

原书依据 · 2 处

19.2.5 设置和获取元素内容

text聚合全部匹配元素文本,html仅读首元素标记;写入HTML与文本有不同解释及副作用。

集合读写有不同返回类型关联本项背景,实质主要讲解在对应位置。

内容表示决定保留的信息关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

19.2.6 获取和设置元素的位置高宽

位置方法先分参照系,尺寸方法分盒层及对象;旧版读写在border-box下可能不对称。

位置包装仍需辨明参照系

offset用文档坐标表示位置,position按偏移父级表示,两者的数值不能直接互换。设置offset还可能调整定位样式;读取与写入因此不是无副作用的同一操作。offsetParent的查找属于库版本契约,不能仅凭方法名字推断与任意浏览器原生属性完全一致。遇到变换、隐藏或特殊定位元素,还应核对支持范围。

位置包装仍需辨明参照系保存独立卡片。

原书依据 · 2 处
尺寸包装先分盒层与版本

本书旧版width读取内容宽,innerWidth加内边距,outerWidth加边框,outerWidth(true)再计外边距;它们测量的盒层不同。1.4.2 width写入直接设CSS width,故border-box下不能假设写入值必然等于内容宽读数。该读写不对称有版本前提,不能直接推广到后来的库;原文context-box应是content-box。

尺寸包装先分盒层与版本保存独立卡片。

原书依据 · 2 处
滚动步长可以由视口派生

按页滚动可先读当前滚动位置,再加上页数乘视口高度,负页数表示反方向。这是计算目标位置,不保证最终位置等于算式:滚动范围会约束结果,页面布局也可能变化。Window视口尺寸、Document整体尺寸与普通元素内容尺寸不是同一量,调用包装API前应明确对象。

滚动步长可以由视口派生保存独立卡片。

原书依据 · 1 处

19.2.7 获取和设置元素数据

数据缓存附着对象但非DOM内容属性,函数作值而非setter回调,undefined不能替代删除。

元素数据缓存有独立生命周期

jQuery data把任意值与元素等对象关联,事件和队列可利用这层缓存;它不是HTML data属性的通用同义词。本书版本把函数第二参数保存为值,不把它调用成计算setter。删除应使用removeData:赋null仍有键,传undefined在1.4.2进入读取分支,不能当清除命令。对象批量写入的替换或合并规则也须按版本判断。

元素数据缓存有独立生命周期保存独立卡片。

原书依据 · 2 处

19.3 修改文档结构

树形修改引出插入、复制、包装与删除,其操作对象和返回集合须分别解释。

节点包含与类型继承分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

19.3.1 插入和替换元素

插入方法成对反转接收者与目标,但参数字符串含义、回调与返回集合并不相同。

插入已有节点会移动它关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处
成对插入接口有不同返回值

append(content)在目标上调用,appendTo(target)在内容上调用;类似的prepend、before、after、replaceWith也有对应形式。两边字符串参数分别表示待插入标记和目标选择器,不能机械交换。前者通常返回原目标集合,后者返回插入结果集合,多目标时还涉及复制,因此链式下一步作用对象可能改变。此处依本书版本说明。

成对插入接口有不同返回值保存独立卡片。

原书依据 · 2 处
插入示例需分清代码与文本

把message放在字符串引号里面,只会产生字面文本,不会读取变量;插入示例中另有缺少$的insertBefore调用。修复语法时还应区分文本消息与可信HTML:普通消息可建文本节点,不能把任意用户内容直接拼进标记。$接收普通字符串通常按选择器解释,文本节点需显式创建。

插入示例需分清代码与文本保存独立卡片。

原书依据 · 1 处

19.3.2 复制元素

克隆节点结构与库层事件数据复制分开,克隆后还需插入且需处理ID冲突。

深克隆结构不等于复制所有状态关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

19.3.3 包装元素

wrap、wrapInner、wrapAll分别包装各元素、各元素内容或整组,改变层级关系。

包装接口决定新增层级范围

wrap为每个选中元素加外层,wrapInner只包其内容,wrapAll把集合按组放入同一个外层。它们改变父子关系,会影响布局和依赖祖先的选择器;不是仅给元素加样式。嵌套模板需明确最内插入处,函数参数的每项调用规则依版本核对,不能把旧wrapAll回调语义当所有版本不变。

wrapAll对选中的原节点做移动而非复制,新的共同包装与被移动节点是两类对象;1.4.2源码先clone包装,再在其最内层append(this),不据参考“复制选中元素”改变身份语义。

包装接口决定新增层级范围保存独立卡片。

原书依据 · 2 处

19.3.4 删除元素

empty/remove/detach分别保留容器、移除并清缓存、移除保留库数据;过滤集合与修改文档不同。

移出文档与清理数据分开

empty清除所选容器的子节点,保留容器自身;remove移出所选节点并清理库管理的事件和数据;detach移出但保留这些状态,便于重新插入。unwrap则移除所选元素的父包装并保留父节点子节点。应依是否还要复用状态选操作;移出文档不等于所有外部引用立即消失或资源已回收。

移出文档与清理数据分开保存独立卡片。

原书依据 · 2 处
集合过滤方向决定保留项

只想从包装集合排除匹配元素,应区分filter保留匹配项与not排除匹配项;两者都不因筛选而把节点移出文档。原文建议filter“从选中元素集中移除”容易颠倒方向,需显式写明保留条件;真正修改文档则是remove等另一类责任。

集合过滤方向决定保留项保存独立卡片。

原书依据 · 3 处

19.4 使用jQuery处理事件

统一事件API为旧浏览器差异提供包装,下一单元按注册、处理、移除展开。

集合操作把查询与批处理连接关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

19.4.1 事件处理程序的简单注册

旧版快捷注册批量附加处理器,hover与toggle重载需区分,移除版本不可忽略。

事件家族不能共用冒泡假设关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处
事件快捷写法受版本约束

jQuery旧版click(f)等快捷方法向匹配集合批量注册处理器,hover(f,g)组合进入与离开事件;toggle(f,g,h)则按点击轮流调用函数,和显示隐藏重载不同。事件toggle在1.9移除,load/unload/error事件快捷方法在3.0移除,不能直接照搬到新版本。维护时先确认版本,再选择对应事件注册API。

事件快捷写法受版本约束保存独立卡片。

原书依据 · 2 处

19.4.2 jQuery事件处理程序

jQuery处理器收到包装事件;false和返回结果由库解释,不是原生addEventListener通用规则。

返回假值不总能取消事件关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处
处理器结果保留最近有效值

jQuery Event.result记录最近一次返回非undefined值的处理器结果,后续无返回值的处理器不一定清空它。它是分派过程中共享的返回记录,不是所有处理器都同意的聚合结果,更不是异步业务操作成功凭证。附加触发参数排在事件对象之后,不能把首参数当自定义业务数据。

处理器结果保留最近有效值保存独立卡片。

原书依据 · 1 处

19.4.3 jQuery事件对象

包装事件复制选定字段并修补历史差异,原生对象、目标与处理器数据仍有不同责任。

监听接收值不同于原始目标关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处
事件包装不保证所有字段有效

jQuery包装事件复制一组选定原生字段,并补齐当时浏览器的target、relatedTarget、pageX/Y与which等差异;字段存在于接口列表不表示每类事件都具备有效数值。originalEvent保留原生对象引用,库补充数据另有用途。移植时应按事件类型和版本解释,不能将旧鼠标按键编码或键码当现代输入字符的通用模型。

事件包装不保证所有字段有效保存独立卡片。

原书依据 · 1 处
包装事件时间不等于发生时刻

jQuery 1.4.2构造包装事件时以当前时间设置timeStamp,表示包装时取得的毫秒时间,不能保证精确等于硬件动作或原生事件创建时刻。它也不必与现代原生高精度事件时间采用同一原点。比较事件耗时前先确认来源与版本,不能把旧Firefox说明当当前实现仍有同一缺陷的证明。

包装事件时间不等于发生时刻保存独立卡片。

原书依据 · 1 处
事件控制与状态查询成对

jQuery事件包装将取消默认行为、停止传播与停止立即传播区分,并提供对应状态查询。取消标志描述事件处理要求,不能证明业务成功或浏览器所有默认行为可取消;停止传播也不等于撤销已运行的处理器。

结构图:

classDiagram
class JQueryEvent {
 +preventDefault() void
 +isDefaultPrevented() Boolean
 +stopPropagation() void
 +isPropagationStopped() Boolean
 +stopImmediatePropagation() void
 +isImmediatePropagationStopped() Boolean
}

事件控制与状态查询成对保存独立卡片。

原书依据 · 1 处

19.4.4 事件处理程序的高级注册

高级绑定支持事件列表、数据、命名空间及对象映射,一次性需按元素与事件类型计。

事件命名空间支持定向管理

jQuery事件名后的点分命名空间用于给处理器加管理标签,便于按模块触发或注销。多个命名空间是标签组合,不是父子层级;空格分隔的事件类型则表示多次注册。模块应使用自己的命名空间缩小清理范围,避免按整个click类型移除其他模块监听。此处bind写法来自旧版本,新代码需查所用版本接口。

事件命名空间支持定向管理保存独立卡片。

原书依据 · 3 处
一次监听按元素事件分别计算

one的限制按每个元素、每种事件类型计算,不是给多个元素和多个事件注册后全局最多调用一次。绑定click和mouseover时两类各自可以触发一次;因此它不能替代业务幂等、防重提交或跨请求唯一性控制。bind与one也不提供原生addEventListener的捕获参数,不能由统一接口推断支持所有事件阶段。

一次监听按元素事件分别计算保存独立卡片。

原书依据 · 2 处
注册时数据不同于触发时参数

bind旧版三参数形式把注册时指定的数据放进event.data,处理器不必另建闭包才能取它;trigger附加参数则可在触发时决定并排在事件对象后。两者表达不同时间点的数据,不要把event.data当来自浏览器的可信验证结果,也不要据“无需闭包”推断值一定深复制。

注册时数据不同于触发时参数保存独立卡片。

原书依据 · 2 处

19.4.5 注销事件处理程序

注销按库、事件名、命名空间及函数引用限定范围,不能注销其他机制注册的监听。

监听器注销需要保留函数身份关联本项背景,实质主要讲解在对应位置。

事件命名空间支持定向管理关联本项背景,实质主要讲解在对应位置。

原书依据 · 7 处

19.4.6 触发事件

手动触发同步调用库处理器并可能调用原生方法,与用户真实操作不等价;triggerHandler还有集合和返回差异。

手动触发不等于真实用户动作

jQuery trigger同步分派库事件,并可能在未取消时调用同名原生方法;嵌套触发会先运行内层再返回。它不能完整复制真实用户动作的校验、用户激活、默认行为或所有监听路径。原文绝对说原生监听不会触发也需限制:库虽不直接逐个分派原生监听,调用click等原生方法仍可能产生原生事件而运行它们。

手动触发不等于真实用户动作保存独立卡片。

原书依据 · 2 处
局部触发不执行原生默认动作

triggerHandler只处理匹配集合的首元素,不冒泡,也不调用对应原生默认方法;返回处理器结果而非可链式集合。旧1.4.2实现先preventDefault再stopPropagation,原文cancelBubble()应更正为方法stopPropagation,cancelBubble是原生属性。它仍可调用on类型属性处理器,不能理解为没有任何副作用。

局部触发不执行原生默认动作保存独立卡片。

原书依据 · 2 处
自定义事件字段不是可信证明

向trigger提供type对象或额外参数,可把调用方数据交给处理器,但自设synthetic字段只是约定,其他脚本也可伪造。事件命名空间、旧click!独占标记及内部全局trigger依版本解释,不构成权限边界。处理器应另行检查业务输入,不能用某个字段真假证明真实用户操作。

自定义事件字段不是可信证明保存独立卡片。

原书依据 · 4 处

19.4.7 自定义事件

自定义事件通过观察者间接调用模块,但同步广播不等待异步保存完成。

广播通知不等于等待工作完成

自定义事件使发布者通知关心某件事的观察者,无需直接调用各模块。示例先广播logoff再立即导航,仅能保证同步处理器被调用,不能保证处理器启动的异步保存已持久化。若导航必须等待保存,应另建明确完成与失败协议;通知机制本身没有交付确认、重试或事务保证。

广播通知不等于等待工作完成保存独立卡片。

原书依据 · 1 处

19.4.8 实时事件

事件委托把监听安在稳定祖先,按传播路径匹配后代,覆盖后来新增节点但依赖事件可到达。

委托按传播路径匹配后代

直接绑定仅作用于当时选中元素,委托则在稳定容器监听,事件到达时再匹配后代,因此后来新增的节点也可响应。匹配不应只检查原始target:点击链接内部子节点时,路径上的链接仍可能命中。若前面的处理器停止传播,事件就到不了容器;选择尽量合适的容器也能缩小匹配范围。

委托按传播路径匹配后代保存独立卡片。

原书依据 · 2 处
旧实时接口依赖选择上下文

旧live从包装对象保存的selector/context建立委托,并非给对象现有每项分别绑定,因此不能把任意事后拼出的集合当等价输入。delegate把容器和选择器显式分开,清理也应对应同一上下文、事件与回调。live/die在1.9已移除,维护时需按版本迁移,不能继续当通用新代码接口。

旧实时接口依赖选择上下文保存独立卡片。

原书依据 · 3 处

19.5 动画效果

动画返回早于完成,默认按元素队列化,时长与禁用选项不保证实际帧率。

动画队列按元素独立串行

默认效果队列让同一元素的后续动画等前一项结束;不同元素各有自己的队列,不构成整个集合统一完成屏障。complete通常逐元素调用,调用方法返回也早于动画完成。这里的异步推进不表示另开JavaScript线程;耗时配置与实际帧呈现还受事件循环和渲染条件影响。

动画队列按元素独立串行保存独立卡片。

原书依据 · 2 处

禁用动画保留最终状态变化

jQuery fx.off把效果时长降为零,使界面直接切到最终状态,可用于减少不必要运动。它不是取消业务操作或移除全部页面动画的通用开关,CSS动画及其他库需另行处理。设计时应提供用户选择并保持最终状态可理解,不能把视觉更愉悦视为所有用户都适用。

禁用动画保留最终状态变化保存独立卡片。

原书依据 · 2 处

19.5.1 简单动画

淡出、显示隐藏、滑动有不同插值属性,但fadeOut完成也会display none,原文占位说明错误。

淡出完成也会退出布局

fadeOut先改变透明度,完成后还会隐藏元素并设置display为none,因此并非始终保留布局占位。只把opacity设为零与调用fadeOut不是同一契约;hide、slideUp也会结束于隐藏,但过渡中变化的属性不同。选择效果时需分清动画过程、完成状态和仍在DOM中的节点,隐藏本身也不是删除数据。

淡出完成也会退出布局保存独立卡片。

原书依据 · 1 处
显示隐藏重载先看是否有时长

本书show/hide及显示toggle在无时长参数时直接切换,有时长才进行渐变;fade和slide系列有自己的缺省时长。fadeTo的第二参数是目标透明度而非回调,不能机械套用另两个fade方法的参数位置。旧toggle函数列表注册事件与显示切换更是不同重载,应先按参数形态读接口。

显示隐藏重载先看是否有时长保存独立卡片。

原书依据 · 1 处

19.5.2 自定义动画

animate区分目标属性和执行选项,非排队动画不构成后续队列等待条件,缓动将时间比例映射进度。

动画目标与执行选项分开

animate第一对象指定属性目标,第二对象指定时长、缓动、回调或队列等执行方式。旧核心主要对数值插值,不会自动对任意颜色或枚举值产生合理过程;像opacity这类无量纲属性也不是默认加像素。仅height:0不完全等于slideUp,因为后者还有隐藏完成状态;示例还需给font-size加引号并将原生this包装后调用text。

动画目标与执行选项分开保存独立卡片。

原书依据 · 2 处
非排队动画可与后续效果重叠

queue:false使动画立即开始而不进入默认串行队列,因此队列里下一段可以在它结束前启动。示例淡入500ms后开始淡出,而宽度动画原计划1000ms,二者会重叠;这些是理想配置时序,不是实测时间保证。若共同写同一属性还可能相互覆盖,应明确哪项完成才允许下一步。

非排队动画可与后续效果重叠保存独立卡片。

原书依据 · 1 处
缓动将时间比例映射成属性进度

缓动函数把已耗时间占总时长的比例映射成属性插值进度,线性映射匀速,swing等非线性映射可先慢后快再慢。目标属性值通常由起值加差值乘进度得到;可全局或逐属性指定缓动。书中平方根等例子用于说明扩展入口,不说明任何自定义函数在所有版本都只收一个参数,也不保证非线性一定更适合用户。

缓动将时间比例映射成属性进度保存独立卡片。

原书依据 · 1 处

19.5.3 动画的取消、延迟和队列

停止当前、清等待队列、跳终值与延迟分别控制不同阶段;队列函数必须推进但不能多次推进。

停止动画需选择队列与终值

旧stop的首布尔参数决定是否清等待队列,第二个决定是否跳到当前动画终值。默认停止当前但保留等待项,随后可继续队列;stop(true)才清等待项。跳终值还可能调用完成回调,不能把“停止”理解为取消全部后续副作用。对用户反复触发的动效,应明确中间值、终值及队列积压各自期望。

停止动画需选择队列与终值保存独立卡片。

原书依据 · 2 处
队列函数完成后才能推进

queue把函数排入元素自己的命名队列,函数完成时调用next或对应dequeue推进。异步函数应在真正结束后推进,不调用会卡队列,重复调用则可能过早启动后项。默认fx队列可自动起步,自定义队列通常需要显式dequeue;静态jQuery.queue只操作队列,不能和实例自动启动逻辑混为一谈。

队列函数完成后才能推进保存独立卡片。

原书依据 · 1 处
延迟队列不保证计时器被取消

delay把等待作为队列项,但旧1.4.2内部只是setTimeout到期后dequeue;清等待数组或stop并不自动撤销已经启动的延迟计时器。把它当可取消防抖可能出现旧计时器继续推进新队列的问题,应按版本检查取消机制,必要时自己管理定时器身份和过期判断。

延迟队列不保证计时器被取消保存独立卡片。

原书依据 · 2 处

19.6 jQuery中的Ajax

Ajax高级便利入口统一委托底层ajax,下一单元开始具体请求处理。

异步请求在回调处理结果关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

19.6.1 load()方法

load加载HTML并替换目标内容,选择器需空格,数据形态改变方法,库状态与HTTP码不同。

请求完成状态不代表成功关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处
片段加载需分开地址与选择器

旧jQuery load(“地址 选择器”)先取得HTML再挑选片段插入匹配集合,地址和选择器之间必须有空格。原例wheather_report.html#temperature缺空格,只是地址片段,不能实现约定的局部选择。插入HTML还涉及执行内容与信任边界,不应当成纯文本显示;轮询也可能请求重叠,固定间隔不保证结果顺序。

片段加载需分开地址与选择器保存独立卡片。

原书依据 · 2 处
加载数据形态影响请求方法

本书load的字符串数据配合默认GET加入查询,对象数据则序列化后用POST;把等价数据从字符串改成对象可能改变HTTP方法。请求完成回调按每个目标元素调用,参数中status是库状态字符串而非HTTP数值码。邮编02134应保存为字符串,裸数字会丢失标识前导零并可能触及旧八进制解释。

加载数据形态影响请求方法保存独立卡片。

原书依据 · 1 处

19.6.2 Ajax工具函数

便利Ajax函数仍区分脚本执行、数据解析、请求方法与序列化;表单禁用不构成幂等。

回调包装数据仍是执行代码关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处
序列化格式必须与服务端约定

param把对象或表单值编码为名值对,数组和嵌套对象使用方括号命名约定;这不等于JSON,也不保证任意服务端能还原同一结构。traditional控制旧式展开方式,实际发送时方括号等字符还会URL编码。需要原始Document等请求体时,processData:false阻止转换,Content-Type则另行匹配内容。

序列化格式必须与服务端约定保存独立卡片。

原书依据 · 3 处
禁用提交按钮不构成业务幂等

点击处理器禁用一个按钮只能限制当前界面入口,不能防止回车提交、其他入口、重试或并发请求。原例把serialize所得字符串交给load,会使用GET而不是据表单method自动选择;响应又替换表单内容。需要明确请求方法、成功与失败恢复、服务端重复处理协议,不能把前端禁用当提交已成功的证据。

禁用提交按钮不构成业务幂等保存独立卡片。

原书依据 · 1 处
响应处理方式决定执行边界

text/html响应类型给回调提供文本,xml/json提供解析对象,script会执行代码,jsonp通过脚本回调交付对象。dataType控制库如何处理响应,并不只是文档标签;省略时的Content-Type推断也可能进入执行路径。应明确预期类型与信任来源,不能把HTTP成功等同内容已安全验证。

响应处理方式决定执行边界保存独立卡片。

原书依据 · 2 处

19.6.3 jQuery.ajax()函数

ajax选项分请求方法、体格式、响应解释、缓存条件、回调与传输钩子,版本矛盾依实际源码处理。

请求完成状态不代表成功关联本项背景,实质主要讲解在对应位置。

取消等待不等于撤销远端操作关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处
请求格式与响应类型是两方向

旧ajax的type选择HTTP方法,contentType描述发送请求体格式,dataType指示响应如何解析或执行,三者不能互相替代。processData控制对象是否编码成名值对,不会因为写了application/json就自动JSON序列化。原文PUSH不是这里应推荐的常见方法示例,可对照PUT/PATCH等具体协议与接口支持。

请求格式与响应类型是两方向保存独立卡片。

原书依据 · 2 处
条件请求需要保存验证器

ifModified用响应Last-Modified和ETag保存验证器,再分别发送If-Modified-Since和If-None-Match;If-None-Match是请求头,不能按原文当响应验证器。304表示可复用此前表示,不带新实体正文,回调须处理无新数据。原文对1.4是否成功前后矛盾,1.4.2源码明确notmodified走成功分支。

条件请求需要保存验证器保存独立卡片。

原书依据 · 1 处
请求默认配置会扩大影响范围

ajaxSetup修改后续请求采用的默认选项,便利函数也可能受影响,局部需求不应无意扩大成全局行为。cache:false通常给GET地址加时间参数,只是改变缓存键的策略,不是清空所有缓存或阻止服务端存储。timeout中止等待也不保证远端操作撤销;缺省零表示未设库超时,不保证网络永不失败。

请求默认配置会扩大影响范围保存独立卡片。

原书依据 · 2 处
请求回调与返回接口依版本变化

jQuery 1.5开始用jqXHR统一请求返回接口,包括不同传输;本书同时保留1.4返回原XHR或undefined的说明,不能混用。旧jqXHR.success/error/complete方法在3.0移除,可对照done/fail/always;这不等于ajax选项对象的同名回调也被删除。无论接口形式如何,回调结果仍应区分传输、解析及业务状态。

请求回调与返回接口依版本变化保存独立卡片。

原书依据 · 2 处
过滤回调与传输钩子分工不同

dataFilter转换响应并返回替代数据,xhr工厂创建传输对象,beforeSend在适用传输发送前允许设置头或取消;它们作用于不同阶段。scriptCharset和JSONP参数名只针对相应脚本传输,不会让服务器自动支持JSONP。旧版跨域脚本有不同回调与错误路径,不能把普通XHR的所有钩子照搬过去。

过滤回调与传输钩子分工不同保存独立卡片。

原书依据 · 1 处
命名回调不等于提供自定义函数

jsonp指定服务器接收回调名的查询参数名,jsonpCallback指定回调函数名,两者不同。1.4.2仅设置一个未占用名字时,库仍会安装包装器并调用success/complete;若该全局名字已被自定义函数占据,源码会保留它,可能绕过正常收尾。因此不能把“指定名字”一概写成禁用正常回调,重名并发也需处理。

命名回调不等于提供自定义函数保存独立卡片。

原书依据 · 1 处

19.6.4 Ajax事件

Ajax事件通知请求生命周期,Start/Stop表示被统计的活动从零到有或归零,不是网络全局状态。

活动请求计数驱动加载提示

ajaxStart在受统计请求从零变为有时通知,ajaxStop在最后一个结束归零时通知,适合统一加载提示。它们不代表页面所有网络活动,global:false请求与其他网络API不一定被统计;也不证明每项业务成功。多个请求重叠时不应按每次success就隐藏提示,应依据所选计数范围。

活动请求计数驱动加载提示保存独立卡片。

原书依据 · 1 处
全局请求事件也有版本边界

本书旧版允许Ajax全局事件绑定任意元素,context还影响部分事件接收者;官方说明自1.9起全局Ajax处理器须附到document。回调与事件参数也不同:事件首参数是事件对象,后接传输对象和配置,不能直接按success回调的位置取数据。global:false仅抑制库事件,不取消请求或所有局部回调。

全局请求事件也有版本边界保存独立卡片。

原书依据 · 2 处

19.7 工具函数

工具函数逐项按遍历、复制、类型判定、转换和代理分组;相似原生API不等价,源码纠正null和空输入边界。

回调包装数据仍是执行代码关联本项背景,实质主要讲解在对应位置。

旧实时接口依赖选择上下文关联本项背景,实质主要讲解在对应位置。

映射集合不保证一进一出关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

工具遍历需核对成员和参数

jQuery each可按对象枚举属性或数组索引遍历,回调参数为键或索引及值,返回false中止;它与实例each、原生forEach的返回和空洞处理不同。grep按谓词筛选,map还会略过null/undefined并展开数组,inArray未命中为-1。选择工具前应核对枚举范围、参数顺序及输出形态,不能只因同名或相似就互换。

工具遍历需核对成员和参数保存独立卡片。

原书依据 · 2 处

合并对象需区分空源与空值

extend把后续源属性复制到目标,同名后者覆盖;1.4.2忽略null/undefined源对象及undefined属性值,却会复制null属性,原文把两层混在一起。true首参数递归合并数组和普通对象,不是任意对象的通用深克隆,也不承诺循环图处理。目标会修改,复制默认配置需先选独立目标并明确覆盖策略。

合并对象需区分空源与空值保存独立卡片。

原书依据 · 2 处

对象判定只回答特定谓词

isEmptyObject问的是有无可枚举属性,包含继承枚举项,不等于没有任何自有属性或没有业务内容。isArray、isFunction和isPlainObject分别识别不同形态,旧实现还有宿主对象限制,不能互相替代,也不能作为不可信输入已验证的充分证据。contains表达后代包含,jQuery自身不算自己的后代,与原生Node.contains边界也应区分。

对象判定只回答特定谓词保存独立卡片。

原书依据 · 2 处

类数组转换有特殊输入边界

makeArray把适合的类数组成员收集为真数组,但1.4.2对字符串、函数与Window另作单值处理,对null/undefined返回空结果,并非所有非类数组都变成一项。merge则把第二列表追加到第一列表并修改第一列表,属于浅层成员复制;得到新数组不意味着元素对象也被复制。

类数组转换有特殊输入边界保存独立卡片。

原书依据 · 2 处

代理函数共享库监听身份

旧proxy创建转发调用并约定接收者的函数,还让代理与原函数共享库GUID,方便注销。但同一原函数产生的多个代理可能共享这一身份,按函数清理时须留意影响范围,可辅以命名空间。书中“不支持部分应用”是旧版,1.6已增加附加参数,3.3又弃用此接口,不能与原生bind全等。

代理函数共享库监听身份保存独立卡片。

原书依据 · 2 处

19.8 jQuery选择器和选取方法

选择器与选取方法都产生匹配集合,后续先辨语法再辨集合变换。

集合操作把查询与批处理连接关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

19.8.1 jQuery选择器

完整读取五张过滤器/组合符图表;区分集合序号与兄弟位次、扩展伪类与CSS、可见性与实际呈现。

选择器关系决定匹配范围关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处
集合序号不同于兄弟位次

jQuery旧:eq/first/even等按当前匹配集合的零基序号筛选,nth-child按各自父元素下全部元素子节点的一基位置判断;两种范围与起点不同。gt(n)选序号大于n的成员,lt(n)选小于n,并非表中文字所写“第n个”。例如nth-child(3n+1)可选第1、4、7等项,不能写成普通奇偶筛选。

集合序号不同于兄弟位次保存独立卡片。

原书依据 · 1 处
库伪类不能直接当标准CSS

jQuery扩展选择器包含文本、位置和表单等过滤条件,不一定能放入CSS样式表或原生querySelector。原例:text(JavaScript)应对照:contains(JavaScript),:text指文本输入控件;表中:parent只是含子节点而非语法上的所有父节点。维护时需区分库扩展与所用CSS标准版本,新标准新增能力也不能反推旧库已支持。

库伪类不能直接当标准CSS保存独立卡片。

原书依据 · 2 处
可见过滤不等于用户看得见

jQuery visible/hidden按版本中的布局盒规则判断,不是视觉可见、进入视口或可交互的同义词。visibility:hidden和opacity:0仍可能符合visible,3.x又允许具有零尺寸布局盒的元素。用它决定业务权限或认为屏幕阅读器必然可访问都会越界;动画过程与完成后隐藏的判断也不同。

可见过滤不等于用户看得见保存独立卡片。

原书依据 · 2 处

19.8.2 选取方法

选取方法返回新包装集合,过滤、后代查找、祖先遍历和栈回退有不同范围与顺序。

集合过滤方向决定保留项关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处
选区提取仍返回包装集合

first/last/eq/slice返回包装集合,而下标访问返回原生元素;越界也可能得到空集合,不能保证永远恰有一项。slice终点不包含在结果里,负序号从尾部解释。链式下一步应按返回类型使用库方法或原生属性,不能把eq(1)与[1]当完全相同。

选区提取仍返回包装集合保存独立卡片。

原书依据 · 1 处
关系遍历要明确边界与顺序

children只取元素直接子代,contents还可含文本等节点;next/prev是紧邻元素,All沿同级扩展,Until在匹配边界前停止。parent与parents范围不同,closest还从自身开始找最近匹配。结果顺序须查方法,prevAll等按逆文档顺序返回,不能用原文“所有都排序为文档顺序”概括。iframe内容访问仍受同源权限约束。

关系遍历要明确边界与顺序保存独立卡片。

原书依据 · 2 处
选区栈回退不撤销文档修改

查找与过滤等产生的新包装对象保存前一选区,end返回前一对象,使后续链条回到旧成员范围;这不会撤销刚才改过的样式或内容。pushStack也返回新包装对象,必须保留该返回值再调用end,原例忽略返回值不能理解为原变量被改写。旧andSelf合并当前和前组选区,在3.0已移除,需对照addBack。

选区栈回退不撤销文档修改保存独立卡片。

原书依据 · 2 处

19.9 jQuery的插件扩展

插件通过原型扩展实例方法,接口、链式返回、局部别名和事件数据命名需协同。

插件原型入口影响全部包装对象

给jQuery.fn添加方法可让包装对象调用它,而给jQuery本身加函数则建立命名空间工具;二者接收者与调用方式不同。插件通常对集合each后返回原集合以保留链式能力,但有自定义结果时应明确返回契约。扩展共享原型会影响使用同一库实例的对象,应减少公开方法并避免覆盖已有名字。

插件原型入口影响全部包装对象保存独立卡片。

原书依据 · 1 处

插件用局部约定管理共享空间

插件可用立即调用函数接收jQuery并命名局部$,减少全局名字冲突;公开方法、事件命名空间与data键采用一致插件名字,便于定位和定向清理。多配置项用对象表达,不能把字符串方法分派做成任意属性调用。该约定帮助协作与生命周期管理,不提供脚本安全隔离。

插件用局部约定管理共享空间保存独立卡片。

原书依据 · 1 处

文本输出要区分节点与包装方法

原例把原生Text节点后接库风格append,不是所示jQuery包装调用;旧环境更不支持这种原生方法组合。可分别把文本节点和br加入目标,保留消息的数据语义;join(arguments,“”)也不会产生注释所说的空格分隔,应明确分隔符。调试输出插件仍应避免把任意消息当HTML执行。

文本输出要区分节点与包装方法保存独立卡片。

原书依据 · 2 处

选择器扩展依赖引擎契约

旧jQuery允许在expr伪类表加入判定函数,按候选元素及参数返回匹配真假;这是选择器引擎插件入口,不会让原生CSS自动识别新伪类。原例:data(x)查data-x属性,和jQuery data缓存不是同一对象。参数数组位置、扩展入口与版本有关,不能将旧四参数或expr[“:”]永远当稳定接口。

选择器扩展依赖引擎契约保存独立卡片。

原书依据 · 1 处

19.10 jQuery UI类库

UI在核心库上构建组件、交互和皮肤,配置、命令与回调不是同一种接口。

界面组件建立在核心库之上

jQuery UI以插件提供日期选择、对话框等组件,以及拖放排序等交互和扩展效果,核心jQuery则处理DOM、样式、事件和请求。使用组件需加载匹配依赖与皮肤CSS;只引脚本不一定有正确外观。组件入口常以选项对象初始化、以字符串命令执行操作,仍须查具体组件和版本,不能把所有命令当真实对象方法。

界面组件建立在核心库之上保存独立卡片。

原书依据 · 1 处

组件回调不一定是可绑定事件

组件文档中的通知可能是选项回调,也可能是事件,注册方式和参数并不统一。Datepicker的onSelect通过选项提供,参数是日期文本与实例,不应套用event、ui的常规事件签名。应先查通知机制再选注册入口;原文多处datapicker拼写错误,实际入口为datepicker。

组件回调不一定是可绑定事件保存独立卡片。

原书依据 · 1 处

第20章 客户端存储

客户端存储包含不同生命周期和自动传输行为;持久性不是永久保证,同源不是磁盘加密。

客户端存储机制各有数据契约

Web Storage保存字符串键值,cookie在匹配请求条件时自动参与HTTP,离线资源缓存针对应用资源,数据库或文件API则面向其他数据组织。它们不是一种可任意替换的永久存储,作用域、容量、清理和失败方式不同。IE userData与AppCache属于本书历史接口;客户端数据不应成为唯一可靠的业务事实来源。

客户端存储机制各有数据契约保存独立卡片。

原书依据 · 1 处

持久保存扩大敏感数据暴露面

把用户输入的信用卡号等敏感信息长期存到客户端,会扩大本机可访问者、恶意软件及同源脚本能接触的范围;用户愿意临时输入并不表示同意长期保存。浏览器存储API不承诺应用级加密,HTTPS只保护相应传输,不能据此断言磁盘一定加密或一定未加密。应按必要性与授权最小化保存,并明确删除与保留期限。

持久保存扩大敏感数据暴露面保存独立卡片。

原书依据 · 1 处

20.1 localStorage和sessionStorage

两个属性返回实现同一接口的不同存储对象,值为字符串;结构化存储假设不是当前Storage契约。

存储接口相同不等于同一对象

localStorage与sessionStorage都实现Storage接口,但不应理解为指向同一对象或同一份数据。Web Storage键和值是字符串,存数字后要按需要解析,存对象通常需显式编码再解码;JSON往返也不能保留所有类型。原文结构化存储展望是假设,不能当今天setItem可直接保存任意对象。

存储接口相同不等于同一对象保存独立卡片。

原书依据 · 1 处

保存前需区分缺失与空字符串

以!name判断会把缺失和已存空字符串混在一起,prompt取消还会返回null;直接赋值可能保存字符串null,而非表示未填写。需要先明确取消、缺失、空值的业务含义再写入,读取数字或JSON也应处理缺失与格式错误。存储成功仅表示API接受该值,不代表已安全验证用户身份。

保存前需区分缺失与空字符串保存独立卡片。

原书依据 · 3 处

20.1.1 存储有效期和作用域

local按源跨会话,session按顶层会话加源;恢复、复制、分区和清理限制绝对说法。

存储范围由源与会话共同决定

localStorage通常按源共享,sessionStorage还按顶层页面会话隔离;同一顶层下同源iframe可共享相应session数据。不同标签不持续共享同一session存储,但新辅助窗口可能取得创建时副本,之后各自变化。源由协议、主机和端口确定,路径不同不提供隔离;浏览器配置与存储分区还会影响实际可访问范围。

存储范围由源与会话共同决定保存独立卡片。

原书依据 · 3 处
持久存储不保证永久保留

localStorage没有应用层自动到期字段,不等于数据永不丢失:用户清理、浏览器策略、隐私模式及存储限制可能使其不可用或移除。sessionStorage随页面会话而存活,浏览器恢复也可能延续会话,不能只按进程退出推断。需要可靠保存的数据应明确备份或服务端持久化方案,不能把浏览器缓存当永久唯一副本。

持久存储不保证永久保留保存独立卡片。

原书依据 · 1 处

20.1.2 存储API

Storage显式方法避免名字冲突并明确字符串返回及删除范围;降级探测本身也可能失败。

存储方法明确读写与删除范围

Storage以setItem(key,value)写字符串,getItem(key)读取或在缺失时返回null,removeItem(key)删除一项,clear清空整块,length/key遍历名称。显式方法能减少键名和接口属性混淆;clear会影响共享该存储的其他同源模块,不能当本模块局部清理。键序也不应当业务排序契约。

结构图:

classDiagram
class Storage {
 +length unsigned long
 +key(index) DOMStringOrNull
 +getItem(key) DOMStringOrNull
 +setItem(key, value) undefined
 +removeItem(key) undefined
 +clear() undefined
}

存储方法明确读写与删除范围保存独立卡片。

原书依据 · 2 处
存储降级不能只用真假短路

访问window.localStorage本身可能因来源或策略抛错,写入也可因配额失败,所以用localStorage||备用实现不能完整检测可用性。备用cookie/userData即使提供同名方法,容量、作用域与传输副作用仍不同;应明确异常处理和能力差异。原文假设结构化副本的例子不是当前字符串Storage真实执行结果。

存储降级不能只用真假短路保存独立卡片。

原书依据 · 1 处

20.1.3 存储事件

storage只通知共享存储的其他窗口,状态未变不通知;事件是同步状态线索,不是锁或事务。

存储变化通知其他共享窗口

storage事件发送给能访问同一存储的其他合适Window,不回送修改者自身;同值写入或删除不存在键不产生变化通知。key/newValue/oldValue描述变化,storageArea指存储,url指发起文档;clear与删除会有null字段。它适合同步偏好,不能充当跨标签原子锁或保证所有业务顺序,修改者自己的界面仍需显式更新。

存储变化通知其他共享窗口保存独立卡片。

原书依据 · 2 处

20.2 cookie

cookie通过文档字符串与自动请求路径交互,身份状态仍需防泄露,启用探测不是逐次成功保证。

脚本读取的Cookie有边界

document.cookie用特殊字符串读写当前可脚本访问的cookie,不是任意Cookie数据库全量读写接口。cookie在符合域、路径、安全和策略条件的请求中自动发送,HTTPS提供传输保护但不把其值自动变成应用加密密文。身份cookie的安全还涉及服务端属性与信任边界,不能因浏览器存储机制就认定内容可信。

脚本读取的Cookie有边界保存独立卡片。

原书依据 · 1 处

存储可用标志不保证操作成功

cookieEnabled等能力标志只能提供粗略线索,不能保证当前上下文、第三方策略和特定属性的写入都被接受。需要时按目标范围尝试写读并清理测试项,同时处理失败,不应将历史“禁用仍允许会话cookie”泛化为所有浏览器策略。启用与同意持久追踪也不是同一件事。

存储可用标志不保证操作成功保存独立卡片。

原书依据 · 1 处

20.2.1 cookie属性:有效期和作用域

Cookie按主机域与路径匹配,不等同源隔离;寿命是上限,Secure约束发送信道。

Cookie范围不同于同源范围

Cookie并不按协议、主机、端口三元组隔离,通常同一主机不同端口也共享,故path=/不能使其范围与localStorage完全相同。未设置Domain时为host-only,设置获准父域可覆盖相应子域,不能任意指定无关域或公共后缀。扩大范围会扩大可接触它的服务,不能把域属性当权限授权。

Cookie范围不同于同源范围保存独立卡片。

原书依据 · 1 处
路径匹配不是脚本安全边界

Cookie Path用于决定哪些路径请求携带该项,默认按设置地址的目录路径;匹配还考虑斜线边界,不能仅做任意字符串前缀。它不隔离同源脚本,同源页面可能通过其他文档访问不同路径可见数据。需要身份或权限隔离时,应由服务端和真实安全边界承担,不能以Cookie路径代替。

路径匹配不是脚本安全边界保存独立卡片。

原书依据 · 1 处
有效期与安全信道分别设置

Max-Age以秒定义保留时长上限,未设到期属性属于浏览器定义的会话寿命,并非简单等同进程结束;浏览器也可提前清理。Secure限制相应安全信道发送,不给Cookie内容自动加密。HttpOnly另行限制脚本读取,是与Secure独立的属性,不能把HTTPS等同防止同源脚本接触所有Cookie。

有效期与安全信道分别设置保存独立卡片。

原书依据 · 1 处

20.2.2 保存cookie

document.cookie赋值只设置一项,编码与范围需匹配,删除不是必须非空值。

Cookie写删需匹配范围

document.cookie赋值设置一项及属性,不替换当前全部Cookie。按约定编码值后写入,读取再解码;更新或删除需命中对应名字、域、路径,删除可设Max-Age=0,值不必如原文要求非空。同名但不同路径项可以共存,未带原Path的删除语句可能只删到另一项。

Cookie写删需匹配范围保存独立卡片。

原书依据 · 1 处

20.2.3 读取cookie

读取返回名值列表不含属性,解析器需避免var覆盖结果对象并处理空格/解码/同名。

解析循环不要覆盖结果对象

getcookie先用cookie保存结果对象,循环又用同名var保存一条字符串;var不是块作用域,后者覆盖前者,最终属性写入与返回都失去原意。应让结果表与当前片段使用不同变量,并逐项处理空白和等号。该问题在后面的cookieStorage复制同段代码时也会复现,不能凭注释认定返回对象。

解析循环不要覆盖结果对象保存独立卡片。

原书依据 · 1 处
Cookie解析需保留歧义

document.cookie提供可访问名值列表而不含Path等元数据,解析时以分号分项、第一等号分名和值,按约定解码。需要去掉分隔空白并处理坏编码、无等号及重复名字,不能把同名不同路径项无声压成可靠唯一值。结果用普通对象还需考虑特殊键,不可信文本不因解析后就成为可信业务状态。

Cookie解析需保留歧义保存独立卡片。

原书依据 · 1 处

20.2.4 cookie的局限性

原文把最低支持容量误说为上限,具体限制依版本实现并受请求负担影响。

Cookie容量并非统一上限

本书把旧RFC容量建议写反:RFC2965列出至少支持300个、每域20个和每项4096字节,并非禁止超过这些数量;RFC6265又列出不同最低能力。实际配额由浏览器和策略决定,不应写死成通用最大值。Cookie适合少量状态,匹配请求自动携带也增加传输负担,不宜当大对象持久库。

Cookie容量并非统一上限保存独立卡片。

原书依据 · 1 处

20.2.5 cookie相关的存储

Cookie适配器暴露相近方法但缺事件和实时状态,样例变量提升、空值和删除范围均需处理。

适配器方法相同不保证语义相同

cookieStorage用键列表和内存表包装getItem/setItem/removeItem/clear等Storage式入口,但没有原生存储事件,也不自动追踪其他页面或服务端对Cookie的修改。缓存快照、请求自动携带和容量限制仍不同;接口相似不能证明能在任何使用Storage的地方透明替代。封装前需明确生命周期及一致性责任。

适配器方法相同不保证语义相同保存独立卡片。

原书依据 · 1 处
函数内同名var会遮蔽外部状态

cookieStorage的setItem末尾声明var cookie保存待写字符串,会提升到整个函数,遮蔽闭包中的cookie表;前面的key in cookie访问的是尚未赋值的局部变量,可直接失败。应把缓存表与输出字符串分名,并在写入成功确认后同步键列表。这个错误不能靠改声明位置消除,根因是函数作用域中的同名遮蔽。

函数内同名var会遮蔽外部状态保存独立卡片。

原书依据 · 1 处
缓存清理须匹配持久层范围

适配器删除和clear未带构造时path,可能清空内存表却未删掉实际Cookie;getItem用值||null还把空字符串当缺失。创建时沿用的解析循环也覆盖结果对象,普通对象in还包含继承项。应同时检查读取、缺失判定、范围删除及失败恢复,不能把内存length更新当持久写删成功。

缓存清理须匹配持久层范围保存独立卡片。

原书依据 · 1 处

20.3 利用IE userData持久化数据

IE userData是历史专属行为,load/save以命名存储持久化属性,兼容层只实现部分Storage。

保存前需区分缺失与空字符串关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

旧持久化行为需要显式保存

IE userData通过历史DHTML行为给元素加命名存储能力,load载入后以属性读写,修改后save才保存;expires设寿命。它有自身目录范围与配额,不是现代通用Storage。示例UserDataStorage只包装get/set/remove,不实现length/key/clear等完整接口,不能因方法同名宣称完全可替换。

旧持久化行为需要显式保存保存独立卡片。

原书依据 · 1 处

20.4 应用程序存储和离线Web应用

历史AppCache缓存应用资源,数据持久化与联网同步仍是独立责任,不保证永久驻留。

离线资源与离线数据分别保存

离线应用既要能载入运行所需资源,也要保存用户数据并在恢复网络后同步;资源缓存本身不解决数据冲突或上传确认。AppCache是本书年代的清单式应用资源机制,已从Chrome及其他Chromium浏览器移除,不能照此部署新应用。“不会被清理、一直驻留”也不是可依赖的持久保证。

离线资源与离线数据分别保存保存独立卡片。

原书依据 · 1 处

20.4.1 应用程序缓存清单

历史清单按CACHE/NETWORK/FALLBACK声明资源路由;首行、MIME、相对路径与选择规则分别约束。

缓存清单声明资源获取策略

历史AppCache由HTML manifest指向清单,首行CACHE MANIFEST、text/cache-manifest响应类型与清单相对URL共同确定资源。CACHE列离线资源,NETWORK列允许通过网络的命名空间,FALLBACK用前缀与替代资源配对;NETWORK:*允许其他资源联网。它们是资源请求路由策略,不是业务接口权限控制或自动数据同步。

缓存清单声明资源获取策略保存独立卡片。

原书依据 · 1 处
清单示例需保留成对回退项

FALLBACK每项需要前缀与缓存替代URL两部分,不能把原例连写的videos/offline_help.html直接当完整配对规则;应表达如videos/和offline_help.html两个项。区域头大小写也按真实语法,NETWORK不能随意写成Network。带清单的主文档可成为隐式主条目,但不能因此认为任意未列资源都会自动缓存。

清单示例需保留成对回退项保存独立卡片。

原书依据 · 1 处

20.4.2 缓存的更新

更新清单触发缓存代际下载,首次缓存与更新完成不同;swapCache不替换已运行资源。

清单变化驱动资源代际更新

历史AppCache检查清单变化后再更新其资源集合,单独修改脚本而不改清单可能仍运行旧缓存。下载新代际完成也不代表当前页面已切到新代码:当前文档可继续绑定旧缓存,下次载入才采用新代际。需要将资源、清单版本与生效时机一并管理,不能把检查成功当最新代码已运行。

清单变化驱动资源代际更新保存独立卡片。

原书依据 · 1 处
缓存更新事件区分首次和升级

checking后可能无更新、下载、错误或废弃;下载完成首次缓存通知cached,已有缓存升级通知updateready。progress表示下载进展,不能把调用次数当精确百分比,计算比例还需有效total。error也不只代表离线,清单或资源错误可导致失败,2011草案把这些事件定义为可取消并设进度UI默认行为,但具体呈现仍依浏览器,不能推广为所有现代事件都可由false取消。

缓存更新事件区分首次和升级保存独立卡片。

原书依据 · 2 处
切换缓存不会重载现有代码

swapCache只切换后续资源获取所用缓存,不重新执行已载入的脚本或替换现有DOM,可能把旧运行时代码与新资源混用。需要设计可兼容的切换点,或让新文档采用新版本;调用还受UPDATEREADY/OBSOLETE等历史状态限制。update只是发起检查,不是同步更新完成。

切换缓存不会重载现有代码保存独立卡片。

原书依据 · 2 处

20.4.3 离线Web应用

完整读取PermaNote三文件与全部事件逻辑,区分本地保存、上传版本与远端冲突,示例没有可靠确认协议。

离线编辑与远端同步各有状态

PermaNote先把文本和修改时间保存到localStorage,空闲后尝试PUT,载入或恢复网络时GET远端并比较版本,冲突时请用户选择。资源离线可用不代表数据已传到服务器,navigator.onLine也不能证明目标服务可达。原例只演示单笔记与时间比较,认证和多用户隔离假设在服务端,没有完整实现。

离线编辑与远端同步各有状态保存独立卡片。

原书依据 · 1 处
保存响应只能确认对应版本

PermaNote的save在load事件就标记当前时刻已保存并禁用按钮,既未检查HTTP状态,也未绑定实际上传的文本版本。若请求期间又编辑或多个请求乱序返回,旧响应可误把较新内容标成已保存。应记录发送快照及版本,只确认对应成功响应,保留后续修改的待保存状态;网络完成不是业务持久化证明。

保存响应只能确认对应版本保存独立卡片。

原书依据 · 1 处
客户端时间比较不能解决冲突

用服务端Last-Modified和客户端Date.now比较版本,依赖不同机器时钟及时间粒度,遇到缺失或无效头还可能得到NaN。PermaNote用户选择覆盖也只是冲突策略,不提供并发写入条件校验;另一设备在读取后更新仍可能被覆盖。需要可靠版本标识和条件写入才能判断所覆盖的确是已读取版本,不能把时间戳当唯一真相。

客户端时间比较不能解决冲突保存独立卡片。

原书依据 · 1 处
同步失败也需要解除界面等待

PermaNote载入先禁用编辑器,但GET没有error/timeout收尾时,失败可能使界面长时间不可编辑。卸载前调用异步save也不保证请求完成,延迟保存应处理退出、失败和恢复路径。代码5000毫秒表示五秒,末注释“五分钟”不对;保存本地时还应处理存储异常,不能让数据保护反而阻断输入。

同步失败也需要解除界面等待保存独立卡片。

原书依据 · 1 处
共享本地笔记需要处理窗口竞争

多个同源窗口若共用固定note、lastModified、lastSaved键,可互相覆盖笔记和保存状态;示例没有storage监听或跨窗口冲突协议。单个setItem的状态变化不使多键读改写成为事务,也不与服务器PUT形成原子提交。实际拓展到多窗口或多账户时,应明确隔离键、版本及冲突处理,不能直接沿用单窗口假设。

共享本地笔记需要处理窗口竞争保存独立卡片。

原书依据 · 1 处

第21章 多媒体和图形编程

多媒体覆盖图像、音视频及SVG/Canvas,客户端绘图改变工作分配但不必然更省资源。

客户端绘图改变数据与计算分配

将数据传给客户端再绘制图形,可减少预生成图片的需求,并把部分计算从服务端转到客户端,也方便实时交互。但代码、字体和数据仍有传输与计算成本,不能保证总比图片小或对所有设备更快。应按图形复杂度、变化频率和终端能力选择表示方式,而不是把服务端负担降低当系统总成本必降。

客户端绘图改变数据与计算分配保存独立卡片。

原书依据 · 1 处

21.1 脚本化图片

修改img src触发资源加载,屏幕外Image可提前请求但不是缓存与可用性的强保证。

预请求图片不保证立即可显示

new Image创建尚未插入文档的图像元素,设src可提前发起加载,让后续切换有机会复用资源;这不是保证缓存命中、加载成功或解码完成。应处理load/error等结果,不能设完src就断言图片已就绪。翻转效果还需照顾键盘和触屏的操作语义,图像变化本身不使它成为可访问按钮。

Image.complete=true也可能来自无src/空src或请求已损坏,不是加载成功信号。应结合成功/失败或解码结果及用途判断;naturalWidth/naturalHeight是密度修正后的固有CSS像素尺寸,不是任意文件原始字节或屏幕CSS布局尺寸。

预请求图片不保证立即可显示保存独立卡片。

原书依据 · 3 处

优雅的图片翻转实现方式

data属性声明翻转资源,集中安装监听分离标记与行为,但仍有安装时机和覆盖风险。

内容与行为分离减少耦合关联本项背景,实质主要讲解在对应位置。

预请求图片不保证立即可显示关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

21.2 脚本化音频和视频

媒体元素通过共同接口控制,source提供候选格式,Audio是元素工厂不是自动播放保证。

媒体候选类型仍需实际解码

audio/video可列多个source供浏览器选择格式,MIME和codecs描述候选而非保证所有文件都可播放。audio/video是需结束标签的普通HTML元素,不能照开头示例用自闭合写法;source才是空元素。原文codec应核对为codecs,Flash后备属于历史方案,不能作为当前通用回退。

媒体候选类型仍需实际解码保存独立卡片。

原书依据 · 1 处

媒体共用接口仍保留类型差异

HTMLAudioElement和HTMLVideoElement共享HTMLMediaElement的加载和播放接口,但视频还拥有自身尺寸、海报和画面等能力,不只width/height两个差别。Audio(url)工厂产生音频元素,调用play不等于自动获准发声。

结构图:

classDiagram
class HTMLMediaElement {
 +load() undefined
 +canPlayType(type) CanPlayTypeResult
 +play() Promise
 +pause() undefined
}
class HTMLAudioElement
class HTMLVideoElement
class AudioFactory["Audio(src):工厂,非类型"]
HTMLMediaElement <|-- HTMLAudioElement
HTMLMediaElement <|-- HTMLVideoElement
AudioFactory ..> HTMLAudioElement : 创建

图中play返回Promise按当前规范标明;书内年代示例未处理此返回。继承线表示共用媒体接口,虚线表示工厂创建依赖。

媒体共用接口仍保留类型差异保存独立卡片。

原书依据 · 4 处

21.2.1 类型选择和加载

类型支持返回概率性结论,媒体选择可自动触发,load用于重选不必每次source追加都必须。

类型探测只表示解码支持预估

canPlayType返回空字符串、maybe或probably,表示对给定MIME与编解码参数的支持判断;非空不保证具体资源可下载、解码或获准播放。应把类型探测、请求结果与播放结果分别处理,不能用一个真假分支省略后续失败路径。

类型探测只表示解码支持预估保存独立卡片。

原书依据 · 2 处
重选媒体源会重置加载过程

设置src或显式load可启动媒体资源选择并终止先前加载/播放,替换候选后需明确重新选择。原文说source列表在显式load前绝不会自动开始过于绝对,解析或插入候选也有自动选择条件。preload是加载提示,不能据auto保证只需很短时间或已经缓存全部内容。

重选媒体源会重置加载过程保存独立卡片。

原书依据 · 2 处

21.2.2 控制媒体播放

播放控制与可查询状态共用属性,自动播放和预加载是受策略限制的请求。

播放请求可能被策略拒绝

在load回调调用play或设置autoplay都不保证实际开始播放,当前play返回Promise,浏览器策略可用NotAllowedError拒绝。界面应响应成功、失败及playing/waiting等实际状态,提供用户启动入口;不能把调用完成或paused=false直接当声音已输出。

播放请求可能被策略拒绝保存独立卡片。

原书依据 · 2 处
播放位置速率与静音分开控制

currentTime以秒设置播放位置,volume是0到1的音量,muted是独立静音开关,playbackRate控制速度而defaultPlaybackRate是默认速率。位置还受可寻址范围约束,负速率及平台音量控制不能仅据属性存在推断都支持。设置controls提供原生控件,脚本也应读取事件后的实际状态而非只保留自己上次写入值。

播放位置速率与静音分开控制保存独立卡片。

原书依据 · 2 处
预加载提示不保证资源下载量

preload的none、metadata、auto表达作者对缓冲量的提示,用户偏好、网络条件及播放策略可改变实际行为。未设置时的默认由实现决定,不保证每个浏览器都预取同样元数据;autoplay也是布尔请求而非获准播放证明,写字符串false仍表示属性存在。循环、控件与预取彼此用途不同。

预加载提示不保证资源下载量保存独立卡片。

原书依据 · 2 处

21.2.3 查询媒体状态

媒体状态要区分播放、缓冲、可寻址范围和错误;表中足够播放不表示全部下载。

播放缓冲和可寻址范围分开

played记录已播时间段,buffered记录已缓冲段,seekable记录可跳转段,并非当前正在跳转的一段。TimeRanges可能为空或多段,读取start/end前需检查length;duration还可能NaN或Infinity。直接end(0)/duration只在有限时长、从零连续缓冲等前提下才有百分比意义。

结构图:

classDiagram
class TimeRanges {
 +length unsigned long
 +start(index) double
 +end(index) double
}

start/end按索引返回秒数,越界抛错;这不是可任意修改的普通数组。

TimeRanges.length是区间数,start(i)/end(i)返回各段秒数且越界抛错。规范化区间有序、非空、互不重叠或相接;只看末段终点会掩盖中间未缓存区域。

播放缓冲和可寻址范围分开保存独立卡片。

原书依据 · 3 处
媒体就绪不表示全部下载

readyState区分无数据、元数据、当前帧、后续数据与足够播放的估计,HAVE_ENOUGH_DATA不要求所有媒体字节都下载完。networkState另述网络加载状态,不等同正在播放;error无错为null,读code前须判空。暂停、跳转和结束也各自独立,初始paused=true并不证明曾成功播放。

媒体就绪不表示全部下载保存独立卡片。

原书依据 · 2 处

21.2.4 媒体相关事件

媒体事件表描述加载/播放/交互状态,不是所有运行必按单一顺序出现,属性注册也可用。

媒体事件应结合当前状态解释

loadstart/progress描述获取,loadedmetadata/loadeddata区分元数据和当前内容,canplay与canplaythrough给播放可用性的不同判断;play不等于playing,waiting/stalled/suspend也有不同原因。时间、音量、速率、跳转和结束事件可重复或交错,不能把表排列当固定一次性生命周期或进度保证。

媒体事件应结合当前状态解释保存独立卡片。

原书依据 · 2 处
媒体监听不限于注册方法

原文说媒体事件只能addEventListener而不能属性注册不准确,当前规范明确oncanplay等处理器属性。addEventListener便于组合多个监听并按函数身份清理,但属性式也有其单槽位契约。应按事件和需求选择,不把媒体类型特殊性误读为取消普通事件注册规则。

媒体监听不限于注册方法保存独立卡片。

原书依据 · 1 处

21.3 SVG:可伸缩的矢量图形

完整读取SVG定义、嵌入方式、渐变矩形、pieChart全部代码与时钟HTML/CSS/JS,图62—65均实际查看。

矢量图用几何描述图形

SVG用形状、路径、文本及样式描述图形,可按坐标映射缩放,和直接存每个像素的光栅图不同。几何描述可避免简单图形放大时按原像素块失真,也可通过DOM修改对象;但内嵌光栅图片、滤镜及最终屏幕栅格化仍有分辨率和成本,不能把所有SVG内容都当无条件无限清晰或更小。

矢量图用几何描述图形保存独立卡片。

原书依据 · 1 处

嵌入方式决定可操作的图形上下文

img引用SVG把它作为图像资源,父页面不能直接像访问内联子树一样操作其内部节点;内联svg则进入文档DOM,便于逐形状修改。object还可能有独立文档,可访问性受加载和同源限制,不能笼统等同img。XHTML/XML需命名空间规则,HTML解析器内联SVG另有命名空间处理,旧浏览器限制只是历史背景。

嵌入方式决定可操作的图形上下文保存独立卡片。

原书依据 · 1 处

视口大小与内部坐标分别设置

SVG width/height确定显示区域,viewBox四个数描述内部坐标矩形,浏览器据此映射到视口;两者不必使用相同数值。绘制时仍需区分原点、尺度和保持比例,不能把内部100单位直接当屏幕100像素。pieChart原例拼接viewBox缺分隔空格,无法形成期望四数,应明确保留数值边界。

视口大小与内部坐标分别设置保存独立卡片。

原书依据 · 1 处

图形定义与绘制引用分开

defs中定义可复用渐变或滤镜,绘制形状通过fill或filter的url引用使用;形状的几何、描边、填充与效果各有责任。示例渐变由两个stop规定颜色端点,时钟阴影由模糊、偏移和合并组合产生。定义存在不表示自动绘制,引用ID和生效范围也需正确,不能只看代码有defs就认定效果已应用。

图形定义与绘制引用分开保存独立卡片。

原书依据 · 1 处

比例数据先转换成连续扇区

饼图先求总量,再用每项占比乘2π得到弧度,累计起止角;以圆心加半径乘sin/cos算边界点,配路径形成扇区。应限定有限非负数据且总量为正,数组标签和颜色数量需匹配。全零、负数、溢出或单项整圆不是一般分片公式可直接忽略的边界,图例仅解释对应关系,不替代数据验证。

比例数据先转换成连续扇区保存独立卡片。

原书依据 · 1 处

路径数据需要明确参数边界

SVG路径M移动、L连线、A描述椭圆弧、Z闭合,弧段含半径、旋转、大小弧和扫掠标记及终点。拼接数字必须按语法保留可解析边界,pieChart把半径与后续0直接拼接可能改变数值;应显式分隔。大小弧标记选择超过半圆的一侧,端点重合也不能靠单条弧隐含画出整圆。

路径数据需要明确参数边界保存独立卡片。

原书依据 · 1 处

返回图形节点后仍需插入文档

pieChart用createElementNS构造SVG节点、配置路径和图例,最终返回svg,调用者再决定放在哪个文档位置。构建与安装分离便于组合及检查;返回成功不表示已经渲染、布局正确或数据合法。原例startangle未声明会污染全局或在严格模式出错,不能因函数封装就推断没有外部副作用。

返回图形节点后仍需插入文档保存独立卡片。

原书依据 · 1 处

旋转指针复用已有图形结构

SVG时钟保留静态钟面和指针节点,只改指针绕圆心旋转角:分针每分钟6度,时针每小时30度并加分钟比例。这样不必每次重建全部形状,CSS可独立管理外观。setTimeout每60秒刷新不保证对齐整分钟或准时执行,需每次读取实际时间;秒未计入时显示也并非连续精确走时。

旋转指针复用已有图形结构保存独立卡片。

原书依据 · 1 处

21.4 <canvas>中的图形

Canvas由元素提供位图与上下文入口,上下文执行绘制,不保留每个形状的DOM;区别SVG与不同上下文类型。

画布像素与图形对象分开管理

Canvas二维绘制把命令结果留在位图中,不为每个画出的形状自动建立DOM节点;移除或交互一个形状通常需应用保存模型并重绘相关区域。SVG保留元素树,节点可单独修改。两者都能画复杂图形,但保留对象、命中检测与更新成本不同,不能只按API语法简短选方案。

画布像素与图形对象分开管理保存独立卡片。

原书依据 · 1 处

画布元素与绘制上下文职责分开

canvas元素管理尺寸和上下文入口,getContext(“2d”)返回负责二维绘制的CanvasRenderingContext2D;可能返回null,需先确认成功再绘图。WebGL是不同上下文,不能向它调用二维方法。

结构图:

classDiagram
class HTMLCanvasElement {
 +getContext(contextId) RenderingContextOrNull
}
class CanvasRenderingContext2D {
 +beginPath() undefined
 +arc(x, y, radius, startAngle, endAngle, counterclockwise) undefined
 +fill() undefined
 +fillRect(x, y, width, height) undefined
}
HTMLCanvasElement ..> CanvasRenderingContext2D : 以2d请求获取

虚线表示获取依赖,不是继承;图省略其他绘制接口。

画布元素与绘制上下文职责分开保存独立卡片。

原书依据 · 2 处

21.4.1 绘制线段和填充多边形

路径构建与绘制分开,fill隐式封口不改变路径,closePath影响描边连接,重叠按绕数填充。

路径构建后还需选择描边或填充

beginPath清空当前路径,moveTo开始子路径,lineTo追加线段;这些调用定义几何而不是立刻画出像素。fill按填充样式着色内部,stroke按描边样式画线,都会作用于整条当前路径并保留它。下一形状若不beginPath,旧子路径仍可能被重复绘制;这与清除画布像素是另一回事。

路径构建后还需选择描边或填充保存独立卡片。

原书依据 · 2 处
隐式填充闭合不改变描边路径

开放折线fill时会为内部判定隐式闭合,但不会给原路径加边,所以随后stroke仍只画已有线段。closePath显式闭合子路径,接缝按连接方式处理;lineTo回起点则是线段首尾相遇,端点处理仍可能不同。粗线下差异更明显,不能只凭细线视觉相似判定语义相同。

隐式填充闭合不改变描边路径保存独立卡片。

原书依据 · 2 处
绕数方向决定重叠区域填充

默认非零规则将绕行方向作为带符号贡献,点的总绕数非零就属于内部,反向嵌套轮廓可抵消形成洞。示例六边形顺时针、内部正方形逆时针,内部贡献相消而不填充;同方向则不会挖洞。现代API也有evenodd规则,不能把非零说成唯一可选规则;边界点与相切射线需按实际算法处理。

绕数方向决定重叠区域填充保存独立卡片。

原书依据 · 2 处
多边形助手只追加几何子路径

polygon用等分圆周角生成正n边形,moveTo首顶点,lineTo后续顶点,closePath收尾;它不beginPath也不fill/stroke,因此调用者可组合多个子路径后统一绘制。角度用弧度,方向标记决定顶点顺序;n、半径和坐标需要有效取值,不能把教学函数当已验证任意输入的几何库。

多边形助手只追加几何子路径保存独立卡片。

原书依据 · 1 处

21.4.2 图形属性

绘图属性与命令分离,save/restore只管状态不管路径/像素,原型工具不是完整状态快照。

绘图样式属于可变上下文状态

fillStyle/strokeStyle决定填充和描边样式,lineWidth/端点连接控制线,字体对齐管文本,透明度、合成和阴影影响绘制。这些是上下文当前状态,命令使用调用时的值,路径几何可由其他函数建立。未主动设置状态的函数会受调用者影响,复用绘图代码需明确状态输入和恢复责任。

绘图样式属于可变上下文状态保存独立卡片。

原书依据 · 2 处
状态栈不保存路径和已有像素

save将当前绘图状态压栈,restore取回最近状态,包含样式、变换与裁剪;当前路径、当前点及已绘位图不随栈恢复。于是restore不能撤销已经画出的线,也不能恢复一条旧路径。同一画布反复getContext(“2d”)通常得到同一上下文,不能靠再次获取创造一套独立画笔状态。

状态栈不保存路径和已有像素保存独立卡片。

原书依据 · 2 处
属性复制工具不是完整状态快照

示例attrs只枚举部分属性,不含变换和裁剪,因此不能替代save/restore;写入for-in还可能处理继承项或任意字段。revert执行restore再save,是取回并重存栈顶状态而不是恢复出厂设置,空栈时也有不同前提。扩展原型影响共享接口,应说明作用域及冲突,而不能把便利工具当原生保证。

属性复制工具不是完整状态快照保存独立卡片。

原书依据 · 1 处

21.4.3 画布的尺寸和坐标

位图尺寸与CSS显示尺寸不同,设置宽高重置上下文,设备像素关系不能交给无关设计问题。

重设画布尺寸会重置绘图状态

设置canvas宽或高会重新初始化二维位图和上下文状态,即使写回相同值也会清掉像素、路径及状态栈。它不同于仅修改CSS显示宽高;后者通常缩放现有位图显示。尺寸变化后需按模型重绘并重新设置必要状态,不能把它当保留画面的普通布局操作。

重设画布尺寸会重置绘图状态保存独立卡片。

原书依据 · 2 处
位图分辨率与显示大小需匹配

画布的位图尺寸、CSS布局尺寸与设备像素比例需要分别管理。仅把小位图用CSS放大可能模糊,高密度显示也可能需要更大的位图及相应坐标缩放;这会影响内存、绘制成本和指针坐标换算,属于编程责任。坐标可用小数并由栅格化处理,不表示实际位图自动具有无限分辨率。

位图分辨率与显示大小需匹配保存独立卡片。

原书依据 · 1 处

21.4.4 坐标系变换

坐标变换将局部点映射到默认系,组合顺序影响结果,矩阵支持平移/缩放/旋转/错切,递归示例用变换替代重复几何计算。

坐标变换组合顺序影响结果

先translate再scale,局部点映射为sxx+dx;先scale再translate则为sx(x+dx),平移量也被缩放,两个调用顺序不同。旋转使用弧度,在默认向下Y轴中正角呈顺时针;翻转坐标轴后视觉方向又可能改变。变换还影响文本和描边,不能只当移动一个形状中心。

坐标变换组合顺序影响结果保存独立卡片。

原书依据 · 1 处
仿射矩阵可组合也可直接替换

Canvas六参数表示x′=ax+cy+e、y′=bx+dy+f;transform在当前矩阵上组合,setTransform直接设矩阵。仿射保持直线和非退化平行关系,不表示能做鱼眼等非线性变形;缩放为零等退化情形也不能假定距离或可逆性。临时默认系操作可save后设单位矩阵,再restore,不能把setTransform当增量平移。

仿射矩阵可组合也可直接替换保存独立卡片。

原书依据 · 2 处
绕点旋转需核对矩阵符号

绕点旋转可用平移到该点、旋转、再平移回去组合,或写等价六参数矩阵。原例rotateAbout用(ct,-st,st,ct),与正文正角公式符号相反,在默认屏幕坐标下不是注释声称的正角顺时针。验证时应选简单点和90度预期检查方向及固定中心,不可仅因函数名正确就相信公式。

绕点旋转需核对矩阵符号保存独立卡片。

原书依据 · 1 处
递归变换复用局部绘图动作

科赫边递归把一条边拆成四条各缩为三分之一的子边,局部旋转安排凸起,底层始终lineTo(len,0)。save/restore恢复父坐标系,随后平移到边终点,使下一边从新局部原点继续。递归层数须为受限非负整数;线段数随层数指数增长,不能把短代码当低计算成本。

递归变换复用局部绘图动作保存独立卡片。

原书依据 · 1 处

21.4.5 绘制和填充曲线

圆弧按圆心角度或切线控制,贝塞尔按控制点决定曲线,不同方法参数和当前点不同。

圆心弧与切线弧使用不同参数

arc以圆心、半径及起止角定义圆弧,有当前点时先连接到弧起点;arcTo以两控制点和半径定义与两条方向线相切的圆角,当前点先连接到切点,不保证经过P1或到达P2。原文arcTo段误写arc参数名称,需按实际签名解释;半径为零退化成连向P1,负半径无效。

圆心弧与切线弧使用不同参数保存独立卡片。

原书依据 · 2 处
贝塞尔控制点不一定落在曲线上

quadraticCurveTo用一个控制点,bezierCurveTo用两个,均从当前点连到指定终点;控制点影响切线和弯曲而非必须经过的中间顶点。例中用fillRect标记控制点,这些标记不成为曲线路径。绘制多个独立子路径需明确moveTo和closePath,不能把圆弧、圆角和贝塞尔当同一参数模型。

贝塞尔控制点不一定落在曲线上保存独立卡片。

原书依据 · 2 处

21.4.6 矩形

矩形快捷绘制与路径追加区分,clear受变换裁剪且不清当前路径,实际签名四数非二。

矩形绘制与路径追加是两类操作

fillRect/strokeRect直接填充或描边,clearRect清除相应区域而不按fillStyle上色,三者不改当前路径;rect则只向当前路径加矩形,需之后绘制。四者实际用x、y、width、height四数,原文“两参数”只是顶点和尺寸两组概念。负宽高改变延伸方向,并不保证与正值同一角位置。

矩形绘制与路径追加是两类操作保存独立卡片。

原书依据 · 2 处
局部清除不等于完整重置画布

clearRect通常清为透明黑,受当前变换与裁剪影响,所以clearRect(0,0,width,height)不一定清掉全部屏幕区域;它也保留当前路径和绘图状态。全画面清理需确认坐标/裁剪前提,而重设尺寸会重置更多状态,两者不能随意互换。不支持alpha的上下文还需按实际配置解释透明效果。

局部清除不等于完整重置画布保存独立卡片。

原书依据 · 2 处

21.4.7 颜色、透明度、渐变以及图案

样式可用颜色/图案/渐变,全局透明乘源透明;HSL注释及渐变作用区域断言需纠正。

颜色模型名称需准确区分关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处
绘制透明度相乘而非修改旧像素

globalAlpha对随后绘制源的透明度作乘法,例如源0.5再乘全局0.5得到0.25;它不会追溯把画布已有像素统一变透明。多次半透明绘制的重叠还受合成规则影响,globalAlpha=0也不是清空画布。需要区分源颜色alpha、绘制全局alpha与最终目标像素结果。

绘制透明度相乘而非修改旧像素保存独立卡片。

原书依据 · 2 处
重复图案来自可用图像源

createPattern用图像源与repeat/repeat-x/repeat-y/no-repeat生成样式,可供填充或描边,源也可是不入文档的画布。必须确认源资源已可用并处理返回失败,未插入DOM并不妨碍画布作为源。图案不为每个形状自动按局部边界重新定义坐标,具体变换和源更新规则仍需按接口核验。

重复图案来自可用图像源保存独立卡片。

原书依据 · 3 处
渐变对象独立于被填充形状

createLinearGradient用两点、createRadialGradient用两圆确定渐变几何,再以addColorStop(offset,color)加色标;fillStyle/strokeStyle引用该对象绘制。offset需在0到1且颜色有效。两色标可形成非恒定渐变,但不是API必须至少调用两次才有效,单色标可形成恒定颜色,无色标则透明。

结构图:

classDiagram
class CanvasRenderingContext2D {
 +createLinearGradient(x0, y0, x1, y1) CanvasGradient
 +createRadialGradient(x0, y0, r0, x1, y1, r1) CanvasGradient
}
class CanvasGradient {
 +addColorStop(offset, color) undefined
}
CanvasRenderingContext2D ..> CanvasGradient : 创建并作为样式引用

CanvasGradient.addColorStop(offset,color)指定0至1的颜色位置,普通非退化渐变中零色标透明黑、单色标呈固定颜色;构造渐变不直接渲染,需交给填充或描边。参考createLinerGradient拼写应为createLinearGradient。

渐变对象独立于被填充形状保存独立卡片。

原书依据 · 3 处
渐变范围不是形状的裁剪框

线性渐变的两点定义变化轴,不把可填形状限定在两点组成的矩形;轴端之外可延展端点颜色。原文说“只能填充该矩形”与此前延展说明矛盾,不能当裁剪契约。径向渐变也要按两圆的几何与退化情况解释,不能把所有非同心圆都简化为小圆内大圆外纯色。

渐变范围不是形状的裁剪框保存独立卡片。

原书依据 · 1 处

21.4.8 线段绘制相关的属性

线宽以路径为中心扩展,描边时变换生效,端点/连接/斜接限制分别控制轮廓。

描边宽度以几何路径为中心

stroke把无限细路径扩成有宽区域,通常两侧各半个lineWidth,宽度还受描边时当前变换影响;非均匀缩放可使不同方向的视觉宽度不同。想遮住内侧可先描边再不透明填充,想限制在内部可先裁剪,但都需明确边界与状态。小数线宽可产生覆盖率混合,不保证在任何底色上都“更暗”。

描边宽度以几何路径为中心保存独立卡片。

原书依据 · 1 处
端点与折角有不同外观规则

lineCap的butt、square、round决定开放端点是否延伸与如何封口,lineJoin的miter、round、bevel决定相连线段折角。miterLimit约束斜接尖角长度与半线宽的比,超过则退为斜切;它不是固定像素长度,也不作用于任意独立线段交叉点。粗线时差异更显著,闭合轮廓还需用真正closePath处理接缝。

端点与折角有不同外观规则保存独立卡片。

原书依据 · 2 处

21.4.9 文本

文本方法直接绘制不改路径,字体与锚点共同定位,测量宽度不等于屏幕最终包围盒。

文本绘制位置取决于对齐与基线

fillText/strokeText以给定(x,y)作为文本锚点,font决定字形度量,textAlign决定水平对齐,textBaseline决定该Y对应的基线。start/end随书写方向而变,不固定等于left/right;字母、表意、悬挂与几何基线是不同参考。绘制受坐标变换,但不会把字形加入当前路径,不能随后clip得到同一文本轮廓。

文本绘制位置取决于对齐与基线保存独立卡片。

原书依据 · 2 处
文本测量结果不是完整屏幕尺寸

measureText按当前字体等状态返回TextMetrics,width可用于布局预估;它不是应用当前画布变换后屏幕像素的完整包围盒。现代TextMetrics还提供字形边界等指标,原文只有width属于历史接口范围。fillText可选maxWidth会限制绘制宽度,字体是否载入及回退也影响结果,不能只测一次就当任何显示条件下固定不变。

文本测量结果不是完整屏幕尺寸保存独立卡片。

原书依据 · 3 处

21.4.10 裁剪

clip交集缩小当前区域而非改写路径,save/restore恢复旧区域,裁剪不撤销已有像素。

连续裁剪取交集而非替换边界

clip将路径覆盖区与当前裁剪区域相交,约束之后绘制,不清除此前区域外已画内容,也不把原路径改写成相交后的形状。连续调用只会进一步约束;先save再clip可在需要时restore旧区域,不能靠再给更大路径就扩回去。beginPath只重置路径,不恢复裁剪,尺寸重置则影响更多状态。

连续裁剪取交集而非替换边界保存独立卡片。

原书依据 · 2 处

21.4.11 阴影

阴影色、偏移与模糊控制绘制效果,偏移不随当前变换旋转,零偏移也非必然不可见。

阴影偏移与物体变换分别解释

Canvas阴影由颜色、X/Y偏移与模糊程度控制,默认透明色看不见;偏移采用不随当前变换旋转缩放的空间,所以改变物体方向不自动改变阴影朝向。shadowBlur也不是简单像素半径。偏移为零仍可因模糊或源透明度而露出阴影,不能绝对说必不可见;偏移变大只改变位置,不保证阴影本身尺寸变大。

阴影偏移与物体变换分别解释保存独立卡片。

原书依据 · 2 处

21.4.12 图片

drawImage按三种重载选源/目标区域,导出属于canvas元素并受origin-clean保护。

图片复制区分源区域与目标区域

drawImage三参数定位整图,五参数再指定目标宽高,九参数同时指定源矩形与目标矩形。源区域按源图像自身坐标取样,目标区域再受目标上下文变换,不能把同一缩放矩阵套在两端。复制本画布区域仍是像素复制而非重建矢量图,放大会暴露栅格化和平滑效果,资源也需先处于可绘制状态。

图片复制区分源区域与目标区域保存独立卡片。

原书依据 · 2 处
画布导出属于元素而非上下文

canvas.toDataURL把位图序列化成数据URL,默认支持PNG,可作图像源;它不是返回DOM截图或保留图形对象结构,也不是上下文绘制命令。导出格式、尺寸和资源成本仍需检查,零尺寸等情形有特殊结果。先绘制再序列化只捕获当时像素,不自动等待所有异步图片完成。

画布导出属于元素而非上下文保存独立卡片。

原书依据 · 2 处
能显示跨源图不等于能读像素

画布可显示某些跨源图像,但使用未获相应CORS许可的源会使位图失去origin-clean,之后toDataURL/getImageData等读取会抛安全错误。污染还可经图案或另一画布传播,不是换个读取方法就能绕过。跨源URL并非必然污染,需看请求模式和服务器许可;重置尺寸能清空位图并重置标志,不保留原内容。

能显示跨源图不等于能读像素保存独立卡片。

原书依据 · 3 处

21.4.13 合成

合成将源与目标按规则组合,透明快照不能简单source-over恢复;局部/全局差异限定历史浏览器。

透明快照恢复需处理目标像素

把半透明画布复制到离屏画布后再用默认source-over绘回,透明部分不会抹掉后来画的内容,因此不等于完整恢复快照。copy按源取代目标而不是简单叠加,但还须考虑裁剪及整个操作范围;也可在明确范围清除后恢复。save/restore只保存状态,不能代替像素备份,恢复流程必须同时管理两层。

透明快照恢复需处理目标像素保存独立卡片。

原书依据 · 1 处
源目标次序与合成规则共同定色

source-over把源叠到目标,destination-over把源放在目标后,in/out/atop依据两侧透明度保留不同区域,copy取源,xor保留互斥覆盖,lighter累加贡献。半透明时不仅是形状集合选择,还会计算颜色和alpha;不能只看名称猜最终颜色。本书十一种是历史范围,现代接口还有混合模式。

源目标次序与合成规则共同定色保存独立卡片。

原书依据 · 2 处
合成范围差异需要按实现版本判断

本书比较旧浏览器按实际绘制局部或整个裁剪区处理透明源的差异,copy等操作可能清掉源外目标。它描述历史实现冲突,不能直接断言当前Chrome仍按旧局部行为或标准后来必改。用整幅离屏源或缩小裁剪可明确所需操作范围,但裁剪近似也不等于所有合成规则完全等价。

合成范围差异需要按实现版本判断保存独立卡片。

原书依据 · 1 处

21.4.14 像素操作

像素读写以ImageData暴露RGBA数据并绕过绘图变换/合成,涂抹算法是递推而非独立卷积。

像素缓冲修改后还需写回位图

getImageData取得一块像素数据,createImageData创建空缓冲,修改data后需putImageData才能更新画布。书中常见格式按行存RGBA四分量、每像素四字节,不能据此推断所有现代颜色格式相同。像素读写绕过当前变换、裁剪、阴影和globalAlpha,不是路径绘制;读取还受origin-clean限制。

结构图:

classDiagram
class CanvasRenderingContext2D {
 +getImageData(sx, sy, sw, sh) ImageData
 +createImageData(sw, sh) ImageData
 +putImageData(imageData, dx, dy) undefined
}
class ImageData {
 +width unsigned long
 +height unsigned long
 +data pixelArray
}
CanvasRenderingContext2D ..> ImageData : 读取或创建后显式写回

图中data表示像素分量数组,具体数值格式依接口配置,不是新增自定义数据类型。

createImageData(existing)创建同尺寸透明缓冲,不复制existing像素。现行create/getImageData以位图坐标及给定宽高确定尺寸,不因设备像素比自动变大;原参考CSS/设备尺寸可不等的说法不可直接套用。putImageData的dirty矩形限制来源位置,但目标仍按dx+x、dy+y定位,不把dirty起点重新当输出原点。

像素缓冲修改后还需写回位图保存独立卡片。

原书依据 · 3 处
原地涂抹会依赖刚更新的邻点

smear从每行第二像素向右扫描,用当前原值的1/n加左侧已更新值的(n-1)/n替换各分量,所以影响会递推向右传播;不是对每个像素独立读取未改原图。要实现不依赖更新顺序的滤波需另存输入或输出缓冲。n需满足有效前提,透明分量和颜色表示也影响视觉结果,不能把该示例称任意图像都正确的物理运动模糊。

原地涂抹会依赖刚更新的邻点保存独立卡片。

原书依据 · 1 处

21.4.15 命中检测

命中路径与命中已绘像素是不同谓词,坐标换算有限前提,代码存在括号与变量错误。

命中检测先统一画布坐标

clientX/Y是视口坐标,需先减画布位置再按布局大小与位图尺寸比例换算,才可用于画布默认坐标的isPointInPath或像素读取。原例按包围矩形线性缩放仅适合简单轴对齐场景,边框、内边距、旋转/错切与零尺寸还需处理,不能把一个比例公式当所有CSS变换的逆变换。

命中检测先统一画布坐标保存独立卡片。

原书依据 · 2 处
路径命中不同于可见像素命中

isPointInPath判断当前路径内部或边界,不自动识别每个已绘图形或描边可见区域;alpha检测判断结果像素是否非透明,阴影、合成和先前内容都可能影响它,透明也不证明从未画过。hitpaint原例误用c而非context,事件示例if缺右括号,需修正后才可验证。像素读取还可能因跨源受限,不能用它绕过安全策略。

路径命中不同于可见像素命中保存独立卡片。

原书依据 · 2 处

21.4.16 画布例子:迷你图

迷你图以内联小图显示趋势,模块从文本解析数值、映射范围再绘线;原例分隔与默认值有边界。

默认值或会覆盖合法假值关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处
迷你图用小图形承载局部趋势

迷你图嵌入文字或数字旁,以很小空间呈现一组数据的走势,而不追求完整坐标轴和大图装饰。尺寸应服务于上下文,仍需保留数据含义及可访问文字,不能因图形紧凑就省略所有解释。示例把原文本放title作提示,但仅有悬停提示不保证键盘与辅助技术能取得同样信息。

迷你图用小图形承载局部趋势保存独立卡片。

原书依据 · 1 处
分隔字符删除会改变数值

原例注释说把换行制表符转为空格,实际却替换成空串,可能把相邻行的12和34连成1234。后续split遇空项再Number还可能变成0,isNaN也不排除Infinity。应先明确分隔语法、排除空输入并验证有限数值,再计算图形;解析失败跳过不等于已有数据被正确展示。

分隔字符删除会改变数值保存独立卡片。

原书依据 · 1 处
图表映射需要处理退化范围

迷你图把数据范围映射到画布高度,最大值靠上,最小值靠下;恒定序列用扩大范围避免除零,但范围输入仍须有限有效。x=width*i/data.length会让最后点留出一段宽度,不是自动铺满两端。新上下文首次lineTo会建立子路径起点,不应误判为必从(0,0)画多余线;需要控制边缘裁切和高密度显示时还应明确坐标尺度。

图表映射需要处理退化范围保存独立卡片。

原书依据 · 1 处

第22章 HTML5 API

HTML5在此是开放Web平台多种API的宽泛名称,本章各接口成熟度按出版年代解释。

平台总称不能代替具体API契约

HTML5在本章泛指一组Web平台技术,涵盖定位、历史、消息、Worker、二进制、存储和套接字,并非每项都由同一版HTML规范定义或具有相同支持范围。书中稳定性、浏览器兼容和示例可运行性是出版时点信息,维护时应分别核对具体API、标准与实现,不由一个“支持HTML5”布尔值推断全部可用。

平台总称不能代替具体API契约保存独立卡片。

原书依据 · 1 处

22.1 地理位置

定位为受权限约束的异步获取与订阅,精度/缓存/超时分工不同,两个完整示例存在零值与注释问题。

定位订阅需要保存取消句柄

getCurrentPosition一次异步获取,watchPosition持续接收位置结果并返回监视ID,clearWatch用该ID停止监视;成功和失败都经回调交付。是否有GPS并非API要求,浏览器可用不同信息源,坐标也不等于精确真实位置证明。用完需结束订阅并处理拒绝、不可用和超时,不能把方法存在当获取成功。

结构图:

classDiagram
class Geolocation {
 +getCurrentPosition(successCallback, errorCallback, options) undefined
 +watchPosition(successCallback, errorCallback, options) long
 +clearWatch(watchId) undefined
}

定位订阅需要保存取消句柄保存独立卡片。

原书依据 · 2 处

定位许可不保证获取成功

位置访问受用户许可、安全上下文与权限策略约束,但可复用已有许可,不能说每次总弹窗。取得位置也不等于获准向任意地图服务上传或长期跟踪;第三方地图URL包含经纬度本身就是一次数据披露。示例只展示机制,实际使用应明确目的、最小化数据和失败回退,不能暗中启动定位。

定位许可不保证获取成功保存独立卡片。

原书依据 · 3 处

精度缓存与超时分别约束定位

enableHighAccuracy请求尽可能较高精度,可能增加等待与耗电;maximumAge约束可接受缓存年龄,timeout限制相应定位等待,二者不是同一失效条件。成功对象外层timestamp表示获取时间,coords含纬度latitude、经度longitude与米制accuracy;原例经纬度注释写反。accuracy是误差估计,不应保证用户必在精确点上。

精度缓存与超时分别约束定位保存独立卡片。

原书依据 · 3 处

可选位置数据需区分零和缺失

海拔0和速度0可以是有效值,按if(value)会把它们误当缺失;应按null等实际缺失契约判断,再解释单位和精度。heading也不能仅因speed存在就当一定有效。whereami不支持分支innerHTMl大小写错误,错误输出应避免无意HTML解释;getmap返回img时定位尚未完成,还需成功/失败及加载处理。

GeolocationCoordinates把可选heading/speed等表示为可空数值,当前规范heading范围为0至不足360度。原书静止时固定NaN的旧约定不当现行唯一缺失表示;纬经度以度计,accuracy以米计,不把不同单位直接相加。

可选位置数据需区分零和缺失保存独立卡片。

原书依据 · 2 处

22.2 历史记录管理

历史状态区分hash字符串、结构化状态和可书签URL,push/replace及pop恢复不是自动UI机制。

片段状态与历史对象各有恢复范围

hash可编码应用状态并借hashchange恢复,pushState保存结构化状态并可关联新URL,replaceState修改当前记录。URL足够描述状态才可用书签或新载入重建,示例#guess次数并不包含完整游戏状态。隐藏到history.state也不是对同源脚本保密,不能把不在地址栏当安全边界。

片段状态与历史对象各有恢复范围保存独立卡片。

原书依据 · 2 处

推入历史不会自动恢复界面

pushState增加记录,replaceState替换当前记录,历史遍历时popstate提供相应state,应用仍要自己渲染。push/replace调用本身不自动发popstate或hashchange;第二参数是历史遗留必传参数,通常空串,原文称可选不准确。URL也必须满足可重写限制,不能任意写跨源地址,更不会因写入URL就加载该资源。

推入历史不会自动恢复界面保存独立卡片。

原书依据 · 3 处

结构化复制不同于JSON往返

结构化序列化可复制部分内建类型和受支持对象图,和JSON字符串往返的类型、循环引用及失败边界不同。函数、DOM节点等通常不能直接保存,不保证保留自定义原型或所有属性语义。原文把Error一概排除是历史信息,当前算法已处理部分错误对象;可复制也不表示适合长期塞入历史记录。

结构化复制不同于JSON往返保存独立卡片。

原书依据 · 2 处

历史恢复不能等待必来的初始事件

猜数字示例首次load先新建状态,却等初始popstate再replaceState;现代环境不保证会发该事件,原书也提醒Firefox4差异。恢复应主动检查history.state并为新记录建立初始状态,再处理后续遍历,而非依赖一次并不存在的通知。初始化、恢复和新一局保存要分清,避免覆盖真实历史。

历史恢复不能等待必来的初始事件保存独立卡片。

原书依据 · 1 处

历史回退只恢复应用自管状态

猜数字游戏把秘密数、范围、次数和最近猜测保存成状态,display统一据状态更新UI,因而能回顾历史猜测;它不撤销外部副作用或任意DOM变更。输入parseInt仍可接受带后缀或截断小数,若要求整数猜测须完整验证。示例1到99随机取数也不保证适合任何公平性或安全需求。

历史回退只恢复应用自管状态保存独立卡片。

原书依据 · 2 处

22.3 跨域消息传递

postMessage允许受限跨窗口通信,目标源约束与接收来源/数据验证是两端责任,完整gadget例不具备完整安全与就绪协议。

跨源消息不授予文档访问权

持有另一窗口引用不代表可读其文档,postMessage允许向它异步发送受支持数据;消息经结构化复制,不是直接共享任意对象。该通信不解除同源限制,也不会自动调用对方业务方法。当前可传可复制对象,不必沿用旧浏览器仅字符串限制;传输失败或接收方未处理仍需自己的协议判断。

跨源消息不授予文档访问权保存独立卡片。

原书依据 · 1 处

发送目标约束与来源校验分开

targetOrigin限制消息交付时目标文档的源,避免窗口导航后误交给未知来源;接收方还需检查event.origin和适当的source,并验证data结构与允许操作。星号允许任意目标源,只应在内容与协议允许时使用;”/“表示发送者同源。origin表示发送时来源,不是对发送方之后状态或数据真实性的永久认证。

发送目标约束与来源校验分开保存独立卡片。

原书依据 · 2 处

就绪通知需要容器真正等待

gadget向父窗口发准备就绪通知,但容器示例没有安装相应message处理或等待,载入后立即为链接配置发送,首条请求可能在gadget监听准备好前丢失。应明确注册监听、验证就绪来源、记录状态和必要请求响应关联;发送成功也不等于搜索已完成,重叠请求的旧结果还可能覆盖新查询。

就绪通知需要容器真正等待保存独立卡片。

原书依据 · 1 处

框架隔离不代替内容安全处理

iframe分离文档能限制直接DOM访问,但普通跨源iframe不是保证无害的完整沙箱。示例仅替换首个小于号,还把tweet文本、用户名和URL拼进HTML,不能当通用上下文编码。接收方只检查source为parent是允许任意嵌入者查询的策略,不适合直接扩展为敏感命令;JSONP还会执行远端脚本,需单独审视信任。

框架隔离不代替内容安全处理保存独立卡片。

原书依据 · 2 处

22.4 Web Worker

Worker引入独立执行环境以移开耗时计算,但不保证无并发责任或任意数量划算。

线程隔离仍需处理并发

专用Worker在独立全局环境执行,不能直接访问主页面Window/Document,适合把重计算移开UI事件循环,再由消息回传结果。现代还可在受限条件共享内存,所以不能沿用“只能复制消息、无需关心并发”的绝对说法;即便仅消息也有顺序、取消与过期结果问题。线程创建和传输有成本,应依任务粒度选择,不以“几十个”作通用配置。

线程隔离仍需处理并发保存独立卡片。

原书依据 · 2 处

22.4.1 Worker对象

外部Worker句柄负责双向消息入口与强制终止,错误是事件不是任意同步调用异常。

外部工作句柄与内部全局分开

new Worker脚本URL创建独立执行环境,外部Worker对象用于发送消息、接收message/error与terminate。它不是内部全局对象本身,也没有Window的targetOrigin参数;原文“postMessage没有参数”应理解为没有目标源参数,消息仍是必需输入。

结构图:

classDiagram
class Worker {
 +postMessage(message, transfer) undefined
 +terminate() undefined
 +addEventListener(type, callback) undefined
 +removeEventListener(type, callback) undefined
}
class DedicatedWorkerGlobalScope {
 +postMessage(message, transfer) undefined
 +close() undefined
}
Worker ..> DedicatedWorkerGlobalScope : 异步消息通信
DedicatedWorkerGlobalScope ..> Worker : 回传消息

图展示两个执行侧的消息关系,不是同对象或继承;transfer是当前API可选传输列表。

外部工作句柄与内部全局分开保存独立卡片。

原书依据 · 2 处
强制终止不是完成确认

terminate可中断执行并丢弃待处理任务,不能保证Worker先执行清理、发最终结果或完成已启动业务动作。应按任务协议区分完成、错误和取消,必要时先请求协作停止再确认。Worker脚本加载/运行错误通过相应error路径报告,主线程仍需收尾资源并避免一直等待成功消息。

强制终止不是完成确认保存独立卡片。

原书依据 · 1 处

22.4.2 Worker作用域

内部全局可定时/加载库/联网但无DOM,classic同步导入与module不同,关闭与错误约定有版本差异。

工作线程全局不是页面全局

Worker内部self指自己的全局,核心语言对象与部分定时/网络API可用,Window/Document不可直接访问;location是只读WorkerLocation而非可导航页面Location。WorkerNavigator也只是相应环境接口,不等于主页面所有能力。不同Worker种类有不同通信入口,专用Worker的全局postMessage不应泛化给全部WorkerGlobalScope。

工作线程全局不是页面全局保存独立卡片。

原书依据 · 2 处
同步导入只适用于相应脚本模型

classic Worker的importScripts按顺序执行导入脚本,完成后才能继续,错误会中断剩余步骤;它不是具备循环依赖管理与去重的模块系统。相对地址依Worker环境解析,载入脚本可再导入。现代module Worker不使用该接口,调用会抛TypeError,应按模块导入规则处理,不能把所有Worker都套旧同步模式。

同步导入只适用于相应脚本模型保存独立卡片。

原书依据 · 2 处
线程自闭需要应用协议收尾

Worker内部close请求停止之后任务处理,外部没有通用onclose确认,因此需要应用层完成/关闭消息和超时策略。即使发过通知,也要明确是否真正结束、还有何资源待清理;不要用“消息监听存在就永不退出”作生命周期保证。被遗弃、终止或环境关闭等情况仍可结束Worker,收到结果后的引用和资源也需管理。

线程自闭需要应用协议收尾保存独立卡片。

原书依据 · 3 处
全局错误返回值有特殊约定

Worker全局onerror采用特殊错误处理约定,当前可收消息、文件、行、列与错误对象,并以返回true表示取消默认错误报告;原文false与三字符串不能作为现行契约。外部Worker.onerror一般收到事件对象,两者签名不同。抑制报告不代表计算恢复或任务成功,应另行定义失败结果。

全局错误返回值有特殊约定保存独立卡片。

原书依据 · 4 处
共享工作服务通过端口通信

SharedWorker可作为多个连接者使用的共享计算环境,连接通过MessagePort收发;MessageChannel创建相连端口,可按传输规则交给窗口或Worker。它不同于专用Worker直接句柄,也不是任意来源都能连接的公共服务。书中“多数未实现”是当时信息,实际能力与生命周期须按当前环境核验,不据概述开放接口。

共享工作服务通过端口通信保存独立卡片。

原书依据 · 1 处

22.4.3 Web Worker的例子

图像例把ImageData复制给Worker并回写,错误/重入与开销仍需管理,同步请求只阻塞本Worker。

把计算移到线程仍有传输开销

图像例在主线程画入离屏canvas并提取ImageData,Worker处理像素后回传,再由主线程回写并导出URL。DOM节点不可直接复制,线程移走循环也没移走主线程提取、复制、编码等成本;新API可转移部分资源但不是原例已实现的零复制。应比较任务量和传输成本,不能凭Worker就保证响应流畅。

把计算移到线程仍有传输开销保存独立卡片。

原书依据 · 1 处
线程任务失败和重入都要收尾

图像例只在成功消息里terminate并清尺寸,缺error、超时和导出失败清理;多次点击还可启动多个Worker,旧结果可能覆盖新图。需要为任务保留身份、过期结果判断及所有结束路径的资源收尾。源图未准备好、尺寸变化和origin-clean限制也不因移到Worker而消失。

线程任务失败和重入都要收尾保存独立卡片。

原书依据 · 1 处
调试消息也需要协议区分

用字符串传调试、ImageData传结果是示例的最小分流协议,实际扩展宜明确消息类型与任务标识,避免日志被当业务输出或任意对象被执行。原文Worker不能console.log是历史限制,当前Console规范面向各全局环境暴露console;不必为所有现代Worker专门绕行日志消息,仍应检查目标环境。

调试消息也需要协议区分保存独立卡片。

原书依据 · 1 处
线程同步请求仍会阻塞该线程

Worker可用同步XHR顺序获取URL,不直接堵住主页面事件循环,但会阻塞该Worker处理后续消息和取消请求,多个URL也没有并行。示例只接受HTTP200,遇到一项错误整体抛出且不返回部分数组;若需其他成功码、重试、超时或部分结果应明确定义。不能把“主线程不阻塞”说成所有场景都理想。

线程同步请求仍会阻塞该线程保存独立卡片。

原书依据 · 1 处

22.5 类型化数组和ArrayBuffer

类型化数组以元素类型解释底层缓冲区,构造复制与视图共享不同,外部字节序用DataView,筛法含边界错误。

数字视图以固定元素格式解释字节

类型化数组按确定数值格式解释底层存储,和可混合值、稀疏或动态增长的普通Array不同;新分配缓冲区通常零初始化,但从其他数组构造会用输入值。书中八类型和固定长度描述是当时范围,现代已纳入核心语言并增加类型、可调整缓冲及跟踪长度能力。用途是明确表示和互操作,不保证所有操作都更快。

数字视图以固定元素格式解释字节保存独立卡片。

原书依据 · 3 处

构造复制与缓冲区视图分开

用已有类型化数组构造新数组可复制元素,subarray则建立同一缓冲区的区域视图,修改任一共享字节会影响其他视图。buffer指底层存储,byteOffset按字节计,length按元素计,byteLength是本视图字节数;buffer.byteLength可能更大。ArrayBuffer普通数字属性不读写真实字节。

结构图:

classDiagram
class ArrayBuffer {
 +byteLength Number
}
class Int16Array {
 +length Number
 +byteOffset Number
 +byteLength Number
 +set(source, offset) undefined
 +subarray(begin, end) Int16Array
}
class DataView {
 +getInt32(byteOffset, littleEndian) Number
 +setInt32(byteOffset, value, littleEndian) undefined
}
Int16Array --> ArrayBuffer : buffer引用
DataView --> ArrayBuffer : buffer引用

线表示共享存储引用,不是复制或继承;offset的单位须按各方法契约判断。

构造复制与缓冲区视图分开保存独立卡片。

原书依据 · 4 处

多字节协议需显式选择字节序

类型化数组多字节视图使用实现的字节序,读取网络或文件字段应先服从格式定义。DataView按字节偏移读写指定宽度,littleEndian省略或false表示大端,true表示小端,不应依赖运行机器碰巧相同。构造需要new DataView(buffer),原例缺new且多处DateView误拼;视图偏移、长度和边界也需检查。

多字节协议需显式选择字节序保存独立卡片。

原书依据 · 2 处

数组标记筛法需说明含端点范围

sieve以数组标记合数再从n向下找未标记数,若n本身是素数会返回n,因此实际是小于等于n,不是注释所说严格小于。n小于2还可能错误返回非素数,需先限定输入。Int8Array每项一字节而非一个位;2到3倍性能是书中年代说明,本轮无基准,不可当普遍保证。

数组标记筛法需说明含端点范围保存独立卡片。

原书依据 · 1 处

22.6 Blob

Blob为不可变字节数据接口,File是其扩展,来源与读出方式相互独立;slice第二参数是结束位置。

数据块接口连接多种二进制入口

Blob表示不可变字节数据与类型,可从文件、网络、数据库或构造数据取得,并由读取、上传、存储或对象URL等API使用。数据不必很大,也不要求先全部读入脚本内存。MIME字符串是元数据,不保证内容真符合该格式;“不透明”指不能直接下标修改字节,不是禁止读取内容。

结构图:

classDiagram
class Blob {
 +size unsigned long long
 +type DOMString
 +slice(start, end, contentType) Blob
}
class File {
 +name DOMString
 +lastModified long long
}
Blob <|-- File

File继承Blob并增加文件名与修改时间;lastModified是当前接口,原文用历史lastModifiedDate。

数据块接口连接多种二进制入口保存独立卡片。

原书依据 · 2 处

数据块切片终点不是长度

当前Blob.slice(start,end,type)取起点至终点前的字节,第二参数不是长度。原例想取最后1KB却给end=1024,对大文件通常得到错误甚至空区;可用负起点或正确末尾边界表达。slice不转码,指定text/plain也不会把任意二进制转成文本。切片与合并各自产生新Blob,不表示原数据被原地修改。

数据块切片终点不是长度保存独立卡片。

原书依据 · 2 处

22.6.1 文件作为Blob

File来自获准选择或构造,选择权限不等于上传同意,FileList非普通数组且元数据不是内容验证。

文件选择不能靠任意路径赋值关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处
文件名类型与修改时间只是元数据

File.name通常不含完整路径,size和type继承Blob,当前lastModified为时间戳,旧lastModifiedDate不要作通用接口。accept提示选择类型而不保证真实内容,客户端与服务端仍需按任务验证。FileList是可索引列表而非普通Array,读取内容可失败,不能据元数据可读认定文件一直存在或全部安全。

文件名类型与修改时间只是元数据保存独立卡片。

原书依据 · 2 处

22.6.2 下载Blob

XHR选择blob响应类型后读取response,load仍需区分HTTP与传输/解析失败。

二进制响应使用对应结果入口

XHR在open后设responseType为blob,完成后从response取得Blob而不是responseText;还需检查HTTP状态并处理error、timeout及取消。load表示相应传输完成,不保证业务成功或返回目标内容。书中“尚无浏览器支持、未测试”属于原例时点,本轮也未运行此函数,不能借现代接口存在宣称示例已通过验证。

二进制响应使用对应结果入口保存独立卡片。

原书依据 · 2 处

22.6.3 构造Blob

历史BlobBuilder可追加字符串/缓冲/Blob,现代Blob构造替代此模式;NUL仅协议约定。

合并字节块需明确编码与协议边界

书中BlobBuilder通过append累加字符串、ArrayBuffer和Blob再getBlob;现代常用Blob构造传入片段序列完成组合,不能直接沿用旧全局构造器。字符串与二进制字段如何解码由协议约定,NUL只是在该教学格式中标记分界,不是Blob自动识别的字符串终止规则。DataView写十个32位整数还需保留字节序与长度。

合并字节块需明确编码与协议边界保存独立卡片。

原书依据 · 2 处

22.6.4 Blob URL

对象URL是Blob映射不是数据编码,寿命/撤销/分区访问受约束,拖放预览还需错误与后续使用管理。

对象URL引用数据而非编码数据

URL.createObjectURL为Blob建立临时映射,返回blob:字符串;它不同于把内容编码进地址的data: URL,也不是直接暴露磁盘路径的file: URL。原文blob://与data://不是应据以构造地址的固定格式。对象URL不适合存到localStorage后期待新会话仍有效,使用者需要保存真实数据或重新创建引用。

对象URL引用数据而非编码数据保存独立卡片。

原书依据 · 2 处
对象URL撤销要匹配使用寿命

映射存在会保留Blob,资源不再需要时应revokeObjectURL,预览读取失败也需要收尾。例中onload马上撤销虽可显示已载图,却可能破坏之后另存或打开原URL等用户操作,回收时机应按真实用途决定;本地File也不能因此完全免除映射清理。撤销不是立刻销毁所有已开始读取或已有数据副本。

对象URL撤销要匹配使用寿命保存独立卡片。

原书依据 · 2 处
对象URL不等于HTTP服务

blob:有自己的源与存储分区限制,不是任意页面拿到字符串都可取;当前还有顶层导航等特殊规则,不能只用“同源文档全有效”概括。失效引用通常产生网络错误,不应把原文404/403描述当实际HTTP服务器响应承诺。它可以被合适Web API读取,但不授予任意本地文件路径权限。

对象URL不等于HTTP服务保存独立卡片。

原书依据 · 1 处
拖放预览需处理载入失败与边界

拖放例从dataTransfer.files过滤image类型,再建对象URL载入预览;MIME前缀只是初筛,不能保证解码成功。需清理失败URL,限制数量/尺寸并考虑子元素触发enter/leave的高亮抖动。兼容检测应检查createObjectURL方法本身而非仅URL对象,onload注册也应和请求启动有明确顺序。

拖放预览需处理载入失败与边界保存独立卡片。

原书依据 · 1 处

22.6.5 读取Blob

FileReader按所需结果异步读取Blob,LOADING不是部分结果承诺,魔数只作初筛,同步API限定线程。

读取器按结果类型启动异步读取

FileReader的readAsText按编码读文本,readAsArrayBuffer读字节,readAsDataURL产数据URL,旧binaryString为兼容接口;成功经load后读取result,失败/取消另走事件。EMPTY/LOADING/DONE表示读取阶段,LOADING启动时即成立且result通常为null,不保证progress可拿部分内容。同一实例忙时不能同时开始第二次读取。

结构图:

classDiagram
class FileReader {
 +readAsText(blob, encoding) undefined
 +readAsArrayBuffer(blob) undefined
 +readAsDataURL(blob) undefined
 +abort() undefined
 +readyState unsigned short
 +result StringOrArrayBufferOrNull
}
class FileReaderSync {
 +readAsText(blob, encoding) DOMString
 +readAsArrayBuffer(blob) ArrayBuffer
}

两个类表示异步事件交付与特定Worker内同步返回的不同契约,无继承关系。

现行abort在EMPTY/DONE仅把result置null并返回;进行中的读取会被终止并发abort,后续loadend还受回调是否开启新读取影响。它不按旧书保证设置FileError.ABORT_ERR;progress也不保证result已有可用部分内容,DONE本身不区分成功或失败。

读取器按结果类型启动异步读取保存独立卡片。

原书依据 · 3 处
文本读取仍需确定编码与输出方式

文本文件读取后用文本节点显示,避免把文件内容当HTML执行。readAsText的编码依参数、媒体类型与解码规则决定,不能将任意字节都看成正确UTF-8文本;用户取消选择也需先检查是否有File。异步回调虽通常可在调用后注册,先注册更清楚,重复选择还需避免旧结果覆盖新文件。

文本读取仍需确定编码与输出方式保存独立卡片。

原书依据 · 2 处
文件头魔数只提供有限识别

读取前四字节并按大端比较可初步识别部分PNG、GIF、PDF或ZIP前缀,但短文件必须先检查长度,四字节匹配不证明完整格式、内容安全或真实MIME。ZIP也包含多种派生格式;verified_type只是脚本添加属性,不修改Blob.type,更不能给上传服务端替代验证。未命中应保留未知而非默认安全。

文件头魔数只提供有限识别保存独立卡片。

原书依据 · 1 处

22.7 文件系统API

历史沙箱文件系统通过Entry/Reader/Writer分阶段操作,异步初始化、目录分批和写入确认均需管理,同步RPC不得任意分派。

沙箱文件系统与整盘权限分开

本书旧requestFileSystem为来源取得私有文件空间,root只是该空间根,不是用户磁盘根权限。PERSISTENT与TEMPORARY描述旧保留策略,配额/授权仍需处理,不能承诺永久不删除。该API属于历史草案,与现代同名文件概念或获用户选择的文件访问机制不能直接混用;只能按当时支持范围维护旧代码。

沙箱文件系统与整盘权限分开保存独立卡片。

原书依据 · 1 处

文件入口与内容读写分阶段取得

旧文件系统root是DirectoryEntry,getFile取得FileEntry,file取得Blob式File供读取,createWriter取得写入器;createReader产生分批目录读取器。对象职责不同,拿到入口不等于已读文件或写入完成。

结构图:

classDiagram
class DirectoryEntry {
 +getFile(path, options, success, error) undefined
 +getDirectory(path, options, success, error) undefined
 +createReader() DirectoryReader
}
class FileEntry {
 +file(success, error) undefined
 +createWriter(success, error) undefined
 +remove(success, error) undefined
}
class DirectoryReader {
 +readEntries(success, error) undefined
}
class FileWriter {
 +seek(offset) undefined
 +write(blob) undefined
}
DirectoryEntry ..> FileEntry : 取得文件入口
DirectoryEntry ..> DirectoryReader : 创建
FileEntry ..> FileWriter : 创建

签名依原书异步旧API,虚线表示获取依赖;同步版本返回值不同,不画成同一接口。

文件入口与内容读写分阶段取得保存独立卡片。

原书依据 · 1 处

异步初始化必须有可用门槛

旧文件工具把filesystem留全局再异步赋值,其他函数若提前调用便无可用root。应把可用性与失败结果显式交付给调用者,而不是依注释假设已经完成。读文件又分入口、File和读取器多步,每步都可失败;仅console.log错误会让上层一直等回调,需有完整结束契约。

异步初始化必须有可用门槛保存独立卡片。

原书依据 · 1 处

文件尾追加不提供并发原子性

旧追加例先seek当前长度再异步write,完成要等写事件;多个写者同时读长度可能相互覆盖,不能推断成原子append。create:true也不等于exclusive:true,前者允许已有项,后者用于要求新建。需要区分找入口、创建和写入成功,并处理Blob构造、配额及读写错误,不能用调用返回当持久完成。

文件尾追加不提供并发原子性保存独立卡片。

原书依据 · 1 处

目录枚举要读到空批次才结束

旧DirectoryReader每次readEntries可只返回一部分入口,要复用同一读取器继续,直到空批次才算结束。累计名字时区分文件和目录,显示附加斜线只是表示约定,不是原入口名改变。异步与同步循环采用同一结束条件,不能拿首批结果当完整目录或据空路径回退隐含扩大删除范围。

目录枚举要读到空批次才结束保存独立卡片。

原书依据 · 1 处

消息分派不能直接开放全局函数

同步文件Worker按外来function字段直接取self属性并apply,混合了通信入口与全局任意函数访问。应限定允许命令、校验参数、绑定请求标识并返回成功/失败结果,避免未知函数、错误参数或异常令调用方悬置。即便线程只能操作沙箱,接口仍需明确可执行范围,不能因消息来自主线程就省略契约。

消息分派不能直接开放全局函数保存独立卡片。

原书依据 · 1 处

22.8 客户端数据库

IndexedDB以命名对象存储、主键和次级索引保存可克隆数据,通过异步请求在事务内工作;旧升级接口、批量导入就绪判断和CSV边界须分别处理。

对象存储用键与索引组织记录

IndexedDB数据库包含命名对象存储区,记录由唯一主键定位,值按结构化克隆规则保存;keyPath指定如何从值中提取键,索引则提供其他字段的查询入口。索引可不唯一,所以按城市查邮编可返回多条记录,不能把城市名当唯一邮编。邮编应保存为字符串,以保留02134的前导零。

对象存储用键与索引组织记录保存独立卡片。

原书依据 · 1 处

键生成需显式配置而非省略键路径

省略keyPath表示键可放在值外提供,不自动等于生成整数键;现行API要启用autoIncrement才有键生成器。原书这条注释不能照搬。put允许替换已有主键记录,add遇已有键则失败,应按业务是否允许覆盖选择,不能把调用成功入队当持久完成。

键生成需显式配置而非省略键路径保存独立卡片。

原书依据 · 1 处

游标继续才会取得后续记录

索引或对象存储的openCursor异步返回游标,读取value后调用continue继续,result为空表示遍历结束。IDBKeyRange描述单键或开闭范围;书中IDBRange写法和new IDBKeyRange.only(city)不可照抄,应使用IDBKeyRange.only(city)静态工厂。逐条回调之外还应给调用者明确的结束与失败信号。

游标继续才会取得后续记录保存独立卡片。

原书依据 · 1 处

事务请求成功仍可能整体回滚

事务将其范围内操作作为整体提交或回滚,某个put请求success不等于事务已经成功;完成应看事务complete,失败看abort及错误。异步请求不会阻塞UI,创建事务与取存储句柄却是同步步骤。不要在事务闲置自动结束后再从任意异步任务续写;自动提交也不承诺掉电后绝不丢失。

事务请求成功仍可能整体回滚保存独立卡片。

原书依据 · 1 处

数据库结构变更有专用升级事务

原书setVersion字符串版次和READ_ONLY等常量属于早期草案。现行做法以indexedDB.open(name, version)指定整数版次,在upgradeneeded的升级事务内创建存储与索引,并处理其他连接阻塞升级。不能把普通open成功回调都当可改结构,也不能直接用旧db.version === “1”识别现代初始化完成。

数据库结构变更有专用升级事务保存独立卡片。

原书依据 · 1 处

导入就绪须确认完整数据与提交

邮编例下载期间逐批建立写事务,再用某条记录查询试探就绪;这不能证明CSV完整、所有批次都已成功,也会把“结构已建好”与“数据已装完”混淆。需检查HTTP状态、每批事务完成、总量或完整性,并有独立装载状态;失败允许重试,不能因版本号已到目标就跳过未完导入。

导入就绪须确认完整数据与提交保存独立卡片。

原书依据 · 1 处

流式文本处理须保留末尾残行

按最后换行切块能避免把尚未接收完整的一行拆开解析,但load时仍要处理没有末尾换行的残行。原例没有此收尾,且简单split逗号不处理CSV引号或转义,字段应校验后再写。numlines累计只是已解析行数,不是成功提交记录数;查询UI也需防止旧异步结果覆盖新输入。

流式文本处理须保留末尾残行保存独立卡片。

原书依据 · 1 处

22.9 Web套接字

WebSocket提供持久双向消息通道,应用仍需约定消息协议、连接状态和业务确认,旧聊天例展示HTTP与WebSocket共用服务器。

双向消息通道仍需应用协议

WebSocket连接建立后两端都能主动发消息,适合替代聊天中一条下行加另一条HTTP上行的组合。它不是任意原始TCP访问权限,消息含义、版本、关联标识与业务确认仍由应用约定。构造器可提供子协议候选,连接后protocol显示协商结果;传输层发送不等于对端业务已处理。

双向消息通道仍需应用协议保存独立卡片。

原书依据 · 2 处

套接字发送应等待连接可用

WebSocket构造启动异步连接,onopen后才是OPEN;CONNECTING时调用send会抛InvalidStateError。应处理message/error/close及资源收尾,按页面协议选合适ws或wss。书中只支持文本是历史范围,现行API也支持Blob和BufferSource,并可配置接收二进制形式,不能继续当成未来功能。

CloseEvent.wasClean描述WebSocket是否按协议干净关闭,false可有网络等原因;true也不证明所有业务消息已经落库或处理成功。close事件本身不可取消、不冒泡,仍需应用自己的待处理消息收尾契约。

套接字发送应等待连接可用保存独立卡片。

原书依据 · 3 处

聊天输入清空不代表发送成功

旧聊天例创建连接后立刻允许输入,onchange可能在连接尚未OPEN时send;change也不只由回车触发。清空输入表示本地UI动作,不证明服务端收到或广播成功,应结合状态禁用、错误反馈和所需业务确认安排;昵称取消、长度与频率边界也需定义。接收时用文本节点可避免直接解释消息为HTML。

聊天输入清空不代表发送成功保存独立卡片。

原书依据 · 1 处

聊天服务分开HTTP与连接事件

示例HTTP请求根路径返回聊天页面,其余404;WebSocket服务包装同一HTTP服务器,连接事件发欢迎消息,message事件广播。职责划分展示共享端口的组织方式,但第三方旧库API不是Node内置API或现行兼容承诺。真实服务还应定义来源/身份校验、消息大小与积压限制、断线处理;原书小例未实现这些策略。

聊天服务分开HTTP与连接事件保存独立卡片。

原书依据 · 1 处

旧套接字服务库只作版本参考

原书服务器依赖miksago/node-websocket-server项目,用其createServer、connection、send和broadcast接口说明消息广播。这里只登记原书所引项目和接口用途,未读项目源码、未验证当前Node兼容性,不能据此推荐安装旧包或关闭浏览器安全拦截。

旧套接字服务库只作版本参考保存独立卡片。

原书依据 · 1 处

第三部分 JavaScript核心参考

核心参考按类或对象名字母排序,成员以类名限定的全名查找;Global仅为文档汇总标题,全局函数与属性不是额外的Global类实例。

JavaScript核心参考

本项仅为核心参考总标题,实质条目在紧随其后的各单元。

arguments[]

普通函数体内的arguments提供本次实参的类数组视图;它不是每种现代函数都有的隐式绑定,全局裸读也不能一律说成undefined。

实参对象记录本次传入列表关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Arguments

Arguments按数值属性保存实参,但不是Array实例,length改动不触发数组截断;与形参联动只在适用的非严格简单形参函数中成立。

实参对象记录本次传入列表关联本项背景,实质主要讲解在对应位置。

参数与索引可取消赋值联动关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

Arguments.callee

callee旧式自引用不适用于严格函数,命名函数表达式可给递归提供自身名字。

命名函数表达式提供内部自称关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

Arguments.length

Arguments.length表示本次实参个数,Function.length表示函数声明的形参长度,两者不自动构成输入有效性的证明。

函数形参长度不等于实参个数关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

Array

Array构造分无参、单数值长度和其他实参成员三种情形;length不是实际已存值数,方法列表按用途另有详细条目。

数组构造器的单数值表示长度关联本项背景,实质主要讲解在对应位置。

数组长度上限不是已存数量关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

Array.concat()

concat返回新外层数组,将普通数组实参展开一层,内嵌数组继续保留,原数组不改。

数组片段复制仍可共享内部值关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

Array.every()

every按索引升序对存在的成员调用判定,首个假值短路,否则返回真,空输入真;回调接收值、索引与数组。

全称与存在有不同空集结果关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Array.filter()

filter按判定保留成员组成新数组,回调可改源数组,接口名应为filter而非概要误写的map。

映射保留位置而筛选压缩成员关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

Array.forEach()

forEach逐项调用回调并忽略返回值,方法返回undefined;遍历起点长度固定,未访问值可变,普通空槽跳过。

逐项执行不提供普通提前成功返回关联本项背景,实质主要讲解在对应位置。

回调式遍历仍可产生副作用关联本项背景,实质主要讲解在对应位置。

缓存长度会固定遍历边界关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

Array.indexOf()

indexOf从起点向后返回首个严格相等位置,失败-1;0是有效命中位置。

索引搜索返回位置而非真假关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Array.join()

join把元素文本以分隔符连接,缺省逗号;与split互逆需要额外的转义和类型约定。

数组文本化会丢失结构边界关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

Array.lastIndexOf()

lastIndexOf从默认尾部或指定起点向前搜索,返回首遇严格相等的索引,未命中-1。

索引搜索返回位置而非真假关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Array.length

数组长度控制索引边界,可大于现有属性数;缩短会删尾部,增大只产生空位置。

数组长度上限不是已存数量关联本项背景,实质主要讲解在对应位置。

缩短数组会尝试删除尾部成员关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

Array.map()

map按位置保存回调返回值于新数组,普通缺失位置跳过而保留空槽,变换不同于筛选。

映射保留位置而筛选压缩成员关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

Array.pop()

pop原地移除尾部,返回原尾值,空输入返回undefined;与push表达栈顺序。

两端操作构成栈与队列关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

Array.push()

push把各实参作为成员加到原数组末尾,返回新长度。

两端操作构成栈与队列关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

Array.reduce()

reduce把累计结果和当前值组合,初始值决定从何开始及空数组结果,回调另接索引和源数组。

折叠初始值决定空输入行为关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

Array.reduceRight()

reduceRight从右端向左组合,非交换运算可能与左折叠不同,初始值规则沿用reduce。

折叠方向影响非交换组合关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

Array.reverse()

reverse重排原数组,其他共享引用可观察到新顺序,不创建独立副本。

原地重排会影响共享数组关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

Array.shift()

shift原地移除并返回首值,后续位置前移,空输入返回undefined。

两端操作构成栈与队列关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

Array.slice()

slice返回半开索引范围的新外层数组,负数从尾部计,源数组不删除成员。

数组片段复制仍可共享内部值关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

Array.some()

some按序找首个真值并短路,空输入为假;要求全体满足应使用另一量词every。

全称与存在有不同空集结果关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Array.sort()

sort原地重排并返回同一数组;默认按字符串比较,自定义比较器的负零正表示先后,undefined不传入比较器。

排序比较需表达一致先后关联本项背景,实质主要讲解在对应位置。

原地重排会影响共享数组关联本项背景,实质主要讲解在对应位置。

原书依据 · 7 处

Array.splice()

splice在原数组局部删除并插入,返回删除成员组成的新数组,零删除也返回空数组。

局部编辑返回被删除的片段关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

Array.toLocaleString()

toLocaleString逐成员调用适用的本地化表示再连接,适合展示而非跨地区稳定序列化。

数组文本化会丢失结构边界关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

Array.toString()

普通数组toString通常调用join得到逗号连接文本;现行算法先取join,可调用则执行,否则回退对象文本。

借用数组方法要满足读写契约关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

Array.unshift()

unshift按参数顺序在头部插入并移动旧位置,返回原数组的新长度;shift移出与它配合。

两端操作构成栈与队列关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

Boolean

Boolean作为转换函数返回布尔原始值,作为构造函数返回包装对象;包装内容false仍不能使对象自身在条件中为假。

转换函数与包装构造分开关联本项背景,实质主要讲解在对应位置。

布尔包装内容不决定对象真假关联本项背景,实质主要讲解在对应位置。

原书依据 · 13 处

Boolean.toString()

Boolean的toString只提取布尔原始值或布尔包装内容为true/false文本,不按任意对象真假生成文本。

布尔包装内容不决定对象真假关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

Boolean.valueOf()

Boolean的valueOf取包装内布尔原始值,接收者必须符合布尔内部槽或原始值要求。

布尔包装内容不决定对象真假关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

Date

Date以毫秒时间值保存瞬间,本地与UTC字段只是解释方式;构造、字段修改和展示方法分工不同,时长计量与日历计算不能混同。

日期字段使用不同索引约定关联本项背景,实质主要讲解在对应位置。

原书依据 · 18 处

日期构造先区分瞬间与字段

new Date()取得当前时间,单个数值是自1970-01-01T00:00:00Z的毫秒值,字符串走日期解析,多数字参数按本地年/月/日等字段建立时间。月份从0开始,省略日默认1,时分秒毫秒默认0;多字段构造的0至99年有加1900兼容规则。直接Date()忽略实参并返回当前时间文本,不返回Date对象。

日期构造先区分瞬间与字段保存独立卡片。

原书依据 · 2 处

时间差不等于日历天数

两个有效日期毫秒值相减给出时间轴上的间隔,除86400000得到固定24小时单位,不保证等于跨本地日期的天数;夏令时转换使本地日长可变。圣诞节例保留当前时分秒再改月日,也未先固定午夜。Date反映系统墙上时间,系统校时会影响用它测出的间隔,不能把页面两次脚本执行间差称为完整页面载入耗时。

时间差不等于日历天数保存独立卡片。

原书依据 · 1 处

日期字段修改会原地归一化

Date的set系列修改同一对象并返回调整后的毫秒值,不返回新的日期对象。可选后续字段省略时通常沿用原值;越界字段会按日历进位或借位,所以保留31日只改到短月可能溢入下一月。需按业务明确字段、时区与有效性,不能把方法列出的正常范围当所有越界都会拒绝。

日期字段修改会原地归一化保存独立卡片。

原书依据 · 15 处

Date.getDate()

本地日号1至31。在有效Date上读取相应字段;无效日期返回NaN,不能把正常取值范围当无条件保证。

日期字段使用不同索引约定关联本项背景,实质主要讲解在对应位置。

原书依据 · 18 处

Date.getDay()

本地星期0周日至6周六,原文6星期一有误。在有效Date上读取相应字段;无效日期返回NaN,不能把正常取值范围当无条件保证。

日期字段使用不同索引约定关联本项背景,实质主要讲解在对应位置。

原书依据 · 18 处

Date.getFullYear()

本地完整年份,不限四位。在有效Date上读取相应字段;无效日期返回NaN,不能把正常取值范围当无条件保证。

日期字段使用不同索引约定关联本项背景,实质主要讲解在对应位置。

原书依据 · 18 处

Date.getHours()

本地小时0至23。在有效Date上读取相应字段;无效日期返回NaN,不能把正常取值范围当无条件保证。

日期字段使用不同索引约定关联本项背景,实质主要讲解在对应位置。

原书依据 · 18 处

Date.getMilliseconds()

本地毫秒分量0至999,不是纪元毫秒。在有效Date上读取相应字段;无效日期返回NaN,不能把正常取值范围当无条件保证。

日期字段使用不同索引约定关联本项背景,实质主要讲解在对应位置。

原书依据 · 18 处

Date.getMinutes()

本地分钟0至59。在有效Date上读取相应字段;无效日期返回NaN,不能把正常取值范围当无条件保证。

日期字段使用不同索引约定关联本项背景,实质主要讲解在对应位置。

原书依据 · 18 处

Date.getMonth()

本地月份0至11。在有效Date上读取相应字段;无效日期返回NaN,不能把正常取值范围当无条件保证。

日期字段使用不同索引约定关联本项背景,实质主要讲解在对应位置。

原书依据 · 18 处

Date.getSeconds()

本地秒0至59。在有效Date上读取相应字段;无效日期返回NaN,不能把正常取值范围当无条件保证。

日期字段使用不同索引约定关联本项背景,实质主要讲解在对应位置。

原书依据 · 18 处

Date.getTime()

getTime直接给Date保存的纪元毫秒,单个时间值不因显示时区改变,无效日期为NaN。

日期毫秒值与显示时区分开

getTime与valueOf读取Date内部时间值,单位是自UTC纪元起的毫秒;同一瞬间用本地或UTC显示并不改变这个数,所以没有单独getUTCTime。它不是getMilliseconds的秒内分量;NaN表示无效日期,比较和相减前应确认有效。有效范围为纪元前后各一亿天,超范围不会变成任意精度日期。

setTime修改同一Date内部时间值,返回转换并裁剪后的值,不保证等于原始实参;非有限或超范围会得到NaN,毫秒小数会截为整数。此操作也不需要额外时区偏移。

日期毫秒值与显示时区分开保存独立卡片。

原书依据 · 4 处

Date.getTimezoneOffset()

getTimezoneOffset返回该日期的UTC减本地的分钟差,偏移会随日期与夏令时规则变化。

时区偏移不能唯一识别地区

getTimezoneOffset返回UTC减本地的分钟数,不能把东八区直接当正480;它取决于目标日期适用的本地时区规则,夏令时可能使值变化。多个地区可有相同偏移,单个数值不能唯一识别IANA地区或判定正在夏令时。无效Date返回NaN,业务若需要地区规则应另存明确标识。

时区偏移不能唯一识别地区保存独立卡片。

原书依据 · 1 处

Date.getUTCDate()

UTC日号1至31。在有效Date上读取相应字段;无效日期返回NaN,不能把正常取值范围当无条件保证。

日期字段使用不同索引约定关联本项背景,实质主要讲解在对应位置。

原书依据 · 18 处

Date.getUTCDay()

UTC星期0周日至6周六。在有效Date上读取相应字段;无效日期返回NaN,不能把正常取值范围当无条件保证。

日期字段使用不同索引约定关联本项背景,实质主要讲解在对应位置。

原书依据 · 18 处

Date.getUTCFullYear()

UTC完整年份,不限四位。在有效Date上读取相应字段;无效日期返回NaN,不能把正常取值范围当无条件保证。

日期字段使用不同索引约定关联本项背景,实质主要讲解在对应位置。

原书依据 · 18 处

Date.getUTCHours()

UTC小时0至23。在有效Date上读取相应字段;无效日期返回NaN,不能把正常取值范围当无条件保证。

日期字段使用不同索引约定关联本项背景,实质主要讲解在对应位置。

原书依据 · 18 处

Date.getUTCMilliseconds()

UTC毫秒分量0至999。在有效Date上读取相应字段;无效日期返回NaN,不能把正常取值范围当无条件保证。

日期字段使用不同索引约定关联本项背景,实质主要讲解在对应位置。

原书依据 · 18 处

Date.getUTCMinutes()

UTC分钟0至59。在有效Date上读取相应字段;无效日期返回NaN,不能把正常取值范围当无条件保证。

日期字段使用不同索引约定关联本项背景,实质主要讲解在对应位置。

原书依据 · 18 处

Date.getUTCMonth()

UTC月份0至11,与从1开始的日号区分。在有效Date上读取相应字段;无效日期返回NaN,不能把正常取值范围当无条件保证。

日期字段使用不同索引约定关联本项背景,实质主要讲解在对应位置。

原书依据 · 18 处

Date.getUTCSeconds()

UTC秒0至59。在有效Date上读取相应字段;无效日期返回NaN,不能把正常取值范围当无条件保证。

日期字段使用不同索引约定关联本项背景,实质主要讲解在对应位置。

原书依据 · 18 处

Date.getYear()

getYear是完整年份减1900的旧接口,新代码应取getFullYear。

旧年份接口带有世纪偏移

getYear返回本地完整年份减1900,不是取后两位;旧setYear又把0至99映射到1900至1999。两者都易把世纪含义隐藏在数字里,维护旧代码时明确偏移,通常用getFullYear/setFullYear表达完整年份。setFullYear(99)表示99年而非自动1999年,不能把构造器兼容规则套给所有方法。

旧年份接口带有世纪偏移保存独立卡片。

原书依据 · 2 处

Date.now()

Date.now作为静态方法返回当前墙上时间毫秒,可用旧Date实例getTime模拟其取值用途。

日期毫秒值与显示时区分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

Date.parse()

Date.parse解析约定日期文本为纪元毫秒,失败NaN;不能假定任意本地化文本都可跨环境往返。

日期解析须约定文本和时区

Date.parse是静态函数,返回毫秒数,不返回Date对象。交换应约定标准日期时间格式及偏移;现行标准中缺偏移的仅日期形式按UTC、日期加时间形式按本地解释,容易把看似接近的字符串变成不同瞬间。非标准文本可能依实现解析,失败为NaN,应先验证;原书旧版解析承诺不能当所有本地化格式互通。

日期解析须约定文本和时区保存独立卡片。

原书依据 · 1 处

Date.setDate()

本条设置本地日历字段并返回调整后的毫秒值,后续可选字段省略时保留对应旧值。

日期字段修改会原地归一化关联本项背景,实质主要讲解在对应位置。

原书依据 · 15 处

Date.setFullYear()

本条设置本地日历字段并返回调整后的毫秒值,后续可选字段省略时保留对应旧值。

日期字段修改会原地归一化关联本项背景,实质主要讲解在对应位置。

原书依据 · 15 处

Date.setHours()

本条设置本地日历字段并返回调整后的毫秒值,后续可选字段省略时保留对应旧值。

日期字段修改会原地归一化关联本项背景,实质主要讲解在对应位置。

原书依据 · 15 处

Date.setMilliseconds()

本条设置本地日历字段并返回调整后的毫秒值,后续可选字段省略时保留对应旧值。

日期字段修改会原地归一化关联本项背景,实质主要讲解在对应位置。

原书依据 · 15 处

Date.setMinutes()

本条设置本地日历字段并返回调整后的毫秒值,后续可选字段省略时保留对应旧值。

日期字段修改会原地归一化关联本项背景,实质主要讲解在对应位置。

原书依据 · 15 处

Date.setMonth()

本条设置本地日历字段并返回调整后的毫秒值,后续可选字段省略时保留对应旧值。

日期字段修改会原地归一化关联本项背景,实质主要讲解在对应位置。

原书依据 · 15 处

Date.setSeconds()

本条设置本地日历字段并返回调整后的毫秒值,后续可选字段省略时保留对应旧值。

日期字段修改会原地归一化关联本项背景,实质主要讲解在对应位置。

原书依据 · 15 处

Date.setTime()

setTime以纪元毫秒直接设置同一日期对象,返回经数值转换与TimeClip后的时间值。

日期毫秒值与显示时区分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

Date.setUTCDate()

本条设置UTC日历字段并返回调整后的毫秒值,后续可选字段省略时保留对应旧值。

日期字段修改会原地归一化关联本项背景,实质主要讲解在对应位置。

原书依据 · 15 处

Date.setUTCFullYear()

本条设置UTC日历字段并返回调整后的毫秒值,后续可选字段省略时保留对应旧值。 本条中间概要误排成setSeconds,应为setUTCFullYear(year,month)。

日期字段修改会原地归一化关联本项背景,实质主要讲解在对应位置。

原书依据 · 15 处

Date.setUTCHours()

本条设置UTC日历字段并返回调整后的毫秒值,后续可选字段省略时保留对应旧值。

日期字段修改会原地归一化关联本项背景,实质主要讲解在对应位置。

原书依据 · 15 处

Date.setUTCMilliseconds()

本条设置UTC日历字段并返回调整后的毫秒值,后续可选字段省略时保留对应旧值。

日期字段修改会原地归一化关联本项背景,实质主要讲解在对应位置。

原书依据 · 15 处

Date.setUTCMinutes()

本条设置UTC日历字段并返回调整后的毫秒值,后续可选字段省略时保留对应旧值。

日期字段修改会原地归一化关联本项背景,实质主要讲解在对应位置。

原书依据 · 15 处

Date.setUTCMonth()

本条设置UTC日历字段并返回调整后的毫秒值,后续可选字段省略时保留对应旧值。

日期字段修改会原地归一化关联本项背景,实质主要讲解在对应位置。

原书依据 · 15 处

Date.setUTCSeconds()

本条设置UTC日历字段并返回调整后的毫秒值,后续可选字段省略时保留对应旧值。

日期字段修改会原地归一化关联本项背景,实质主要讲解在对应位置。

原书依据 · 15 处

Date.setYear()

旧setYear按本地时间改年且0至99加1900,不能按原文参数说明当成UTC设置。

旧年份接口带有世纪偏移关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

Date.toDateString()

toDateString仅给本地日期部分的人类可读文本,不含完整时间信息。

日期展示与交换需要不同格式

Date的toDateString/toTimeString分别显示本地日期/时间,toString合并常见表示;toLocale系列面向用户地区习惯,格式可因环境与选项而异,不是稳定存储协议。toUTCString按UTC显示,toISOString用带Z的标准日期时间文本,适合明确瞬间的交换。任何显示都不改变Date保存的时间值。

toISOString对有效日期用UTC带Z输出,常见形式YYYY-MM-DDTHH:mm:ss.sssZ;扩展年份有符号和更多位数,无效Date则抛RangeError,不能把普通四位模板作为全部合法日期。

日期展示与交换需要不同格式保存独立卡片。

原书依据 · 9 处

Date.toGMTString()

toGMTString为旧UTC文本别名,优先toUTCString;适合相应用途的显示,不能据此推断Date保存了地区或所有显示文本可反向解析。

日期展示与交换需要不同格式关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

Date.toISOString()

toISOString输出UTC带Z的完整标准日期时间文本;无效日期会抛RangeError,扩展年份不只四位。

日期展示与交换需要不同格式关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

Date.toJSON

JSON.stringify借助Date.toJSON输出日期文本,但解析JSON后不自动恢复Date;无效日期序列化为null而非直接抛ISOString错误。

日期序列化后仍需恢复类型关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Date.toLocaleDateString()

本地化日期部分;适合相应用途的显示,不能据此推断Date保存了地区或所有显示文本可反向解析。

日期展示与交换需要不同格式关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

Date.toLocaleString()

本地化日期与时间,环境可能不同;适合相应用途的显示,不能据此推断Date保存了地区或所有显示文本可反向解析。

日期展示与交换需要不同格式关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

Date.toLocaleTimeString()

本地化时间部分;适合相应用途的显示,不能据此推断Date保存了地区或所有显示文本可反向解析。

日期展示与交换需要不同格式关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

Date.toString()

本地时间常见文本,不等同地区习惯格式;适合相应用途的显示,不能据此推断Date保存了地区或所有显示文本可反向解析。

日期展示与交换需要不同格式关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

Date.toTimeString()

本地时间部分文本;适合相应用途的显示,不能据此推断Date保存了地区或所有显示文本可反向解析。

日期展示与交换需要不同格式关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

Date.toUTCString()

UTC人类可读文本;适合相应用途的显示,不能据此推断Date保存了地区或所有显示文本可反向解析。

日期展示与交换需要不同格式关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

Date.UTC()

Date.UTC按UTC字段计算毫秒值,再new Date可取得对应对象;与多字段本地构造的区别是解释基准与返回类型。

日期构造先区分瞬间与字段关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

Date.valueOf()

Date.valueOf返回内部毫秒值,与getTime同值,不因文本格式而变化。

日期毫秒值与显示时区分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

decodeURI()

decodeURI按整体URI规则解码,仍保留结构保留字符的百分转义,不是把所有%xx都替换。

整段URI与组件解码范围不同

decodeURI针对整体URI,像%3F、%2F这类保留结构字符的转义会保留,以免把数据变成分隔符;decodeURIComponent针对独立组件,解码范围更宽。两者都需处理畸形百分编码或无效UTF-8导致的URIError,也不会自动把表单加号变空格。应按真实编码层次解码,不反复解到“看起来正常”。

整段URI与组件解码范围不同保存独立卡片。

原书依据 · 2 处

decodeURIComponent()

decodeURIComponent对组件作解码,错误转义抛URIError;概要误写decodeURI应更正。

整段URI与组件解码范围不同关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

encodeURI()

encodeURI保留整段URI的分隔字符,数据组件含分隔符时应逐组件编码;有效代理对可形成四字节UTF-8,孤立代理项出错。

查询参数按值编码关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

地址编码需区分结构与数据

encodeURI保留URI结构用的标点,不能防止值里的?或#被当结构;encodeURIComponent还编码这些分隔符,适合独立数据片段。两者均按码点的UTF-8字节生成%xx,可能需要一至四字节;原文只列一至三字节不完整。孤立代理项会URIError,编码也不是完整URL合法性、安全性或授权验证。

地址编码需区分结构与数据保存独立卡片。

原书依据 · 2 处

encodeURIComponent()

encodeURIComponent编码独立片段中的URI分隔标点,同时仍保留其规定的未转义字符,不能当所有上下文的通用转义。

地址编码需区分结构与数据关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

Error

Error承载名称与消息等诊断,抛出后由异常控制路径传播;标准文本化有明确规则,不能按旧说明认为完全任意。

异常值携带失败诊断关联本项背景,实质主要讲解在对应位置。

原书依据 · 10 处

Error.message

message用于人类可读诊断,显式参数成为实例消息,省略时可继承空默认值。

异常值携带失败诊断关联本项背景,实质主要讲解在对应位置。

原书依据 · 10 处

Error.name

name通常由相应错误原型提供默认名称,实例可覆写,不是从构造函数直接继承属性。

异常值携带失败诊断关联本项背景,实质主要讲解在对应位置。

原书依据 · 10 处

Error.toString()

标准Error.toString读取name与message,通常返回名称加冒号空格加消息,任一为空有专门规则。

异常值携带失败诊断关联本项背景,实质主要讲解在对应位置。

原书依据 · 10 处

escape()

escape按旧UTF-16码元生成%xx或%uXXXX,与URI函数的UTF-8百分编码不是同一格式。

旧转义不是UTF8百分编码

escape按旧规则把低码元编码为%xx、其他码元编码为%uXXXX,unescape是配套旧解码。它与encodeURI/encodeURIComponent的UTF-8字节百分转义不同,不能把历史escape结果直接交给现代URI解码器期待等价。维护旧数据要先辨认格式,新URL用途用明确组件编码;弃用不等于所有环境都没有该函数。

旧转义不是UTF8百分编码保存独立卡片。

原书依据 · 2 处

eval()

eval对字符串执行独立解析并按直接/间接调用决定环境;严格代码隔离新增声明,但不冻结外层状态。

eval代码需独立满足语法关联本项背景,实质主要讲解在对应位置。

eval结果取决于语句完成值关联本项背景,实质主要讲解在对应位置。

直接与间接eval使用不同环境关联本项背景,实质主要讲解在对应位置。

严格eval隔离新增声明关联本项背景,实质主要讲解在对应位置。

原书依据 · 8 处

EvalError

EvalError保留为旧版本兼容类型,不是现行间接eval必抛异常。

旧求值错误名不代表现行触发

原书EvalError条目描述早期对eval别名的限制;其相邻eval条目已说明ES5间接调用转入全局而不再因此抛EvalError。现行规范保留该构造器以兼容旧版,不能见到eval就预计此错误;语法解析错误或被求值代码自己的异常仍依实际机制处理。

旧求值错误名不代表现行触发保存独立卡片。

原书依据 · 1 处

Function

Function构造器从字符串建立可调用对象,构造与执行分开;函数的length/prototype及旧调用栈属性各有契约。

动态函数不捕获调用点局部绑定关联本项背景,实质主要讲解在对应位置。

函数形参长度不等于实参个数关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

Function.apply()

apply显式提供接收值与实参列表,返回被调用函数的结果;接收值转换依目标函数严格性,列表可为适用类数组。

显式接收者与参数展开是两层关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

Function.arguments[]

function.arguments是旧反射属性,不等于普通函数体内arguments绑定,不宜作为现代代码的数据入口。

旧调用栈反射不宜作为契约

旧function.arguments和function.caller尝试暴露当前调用实参与调用者,不等于函数体内独立arguments绑定。它们弃用且受严格函数等限制,访问可抛TypeError,不能当通用调用链或日志接口。把所需上下文显式作为参数传递,比依赖旧隐式反射更清楚;也不能由旧caller推断所有异步因果关系。

旧调用栈反射不宜作为契约保存独立卡片。

原书依据 · 2 处

Function.bind()

bind创建新函数保存接收值与前置实参,之后调用把新实参接在后面;构造调用另有规则。

预置实参与绑定接收者分开关联本项背景,实质主要讲解在对应位置。

绑定函数构造不使用绑定接收值关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

Function.call()

call把后续实参逐个传给目标并返回其结果,借用方法不等于改变对象已有属性。

显式接收者与参数展开是两层关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

Function.caller()

caller是旧属性而非caller()方法,严格等受限情形访问可抛异常,不能依条目标题当普通undefined。

旧调用栈反射不宜作为契约关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

Function.length()

Function.length是形参元数据,不是本次实际传入个数,也不是方法调用。

函数形参长度不等于实参个数关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

Function.prototype()

可构造函数的prototype通常决定新对象原型,函数自身原型链与此属性不同,继承也不保证所有属性可见或不可遮蔽。

原型引用与构造属性分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

Function.toString()

Function.toString提供函数文本表示,不恢复闭包环境;内置/绑定函数未必是可eval重建源码。

函数文本不保存闭包环境关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

Global

Global是参考页组织名,全局对象提供标准与宿主入口;全局声明与属性关系依脚本/模块及声明类型而异。

全局对象连接标准与宿主入口关联本项背景,实质主要讲解在对应位置。

全局声明不同于直接写属性关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

Infinity

Infinity保存数值正无穷,现行全局属性不可写、不可枚举、不可配置;不能按旧条目称其可任意改值。

特殊数值不总通过异常报告关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

isFinite()

全局isFinite先转换为数值再判断有限,因此可转换文本和null等也可能通过,不等于输入本来就是有限Number。

NaN检测要考虑隐式转换关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

isNaN()

全局isNaN先转换数值再查NaN;NaN不等自身,x!==x可专门识别数值NaN,普通非数值类型不等于NaN。

NaN检测要考虑隐式转换关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

JSON

JSON是数据文本格式及解析/序列化命名空间,不能无损表达任意JavaScript对象图。

JSON往返不是通用深复制关联本项背景,实质主要讲解在对应位置。

JSON省略与空值替换依位置关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

JSON.parse()

JSON.parse先解析有效JSON,reviver在子项处理后对容器及根也调用,可替换或删除结果。

日期序列化后仍需恢复类型关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

恢复回调按子项到根处理

reviver不限原始值,也会在子项处理后收到对象/数组,最后以空字符串键处理根。普通函数this是包含该项的持有对象;返回替代值用于结果,返回undefined删除属性,数组会留空槽,根返回undefined则整体结果如此。原文只对原始值调用的说法不准确;日期恢复还应约定字段与有效性,不能只凭长得像日期的文本。

恢复回调按子项到根处理保存独立卡片。

原书依据 · 1 处

JSON.stringify()

stringify依次使用可选toJSON与replacer替代值,属性名数组和缩进参数另有职责,数组不能靠undefined返回自动压缩。

序列化钩子返回的是替代值关联本项背景,实质主要讲解在对应位置。

JSON省略与空值替换依位置关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

替换函数与属性名单职责不同

JSON.stringify第二参数为函数时可按键和值返回替代值,普通函数this是持有对象,根也会处理;为字符串/数字数组时指定对象属性名单与次序,并不是数组元素筛选器。第三参数控制每层缩进,数值最多10个空格,字符串最多取10个码元;非空白缩进可能使输出不再是合法JSON,展示选项不能承担数据校验。

替换函数与属性名单职责不同保存独立卡片。

原书依据 · 1 处

Math

Math是承载数学常量与函数的普通命名空间对象,不提供Math构造实例;函数按各自数值契约工作。

数学命名空间不提供构造实例

Math.E/PI等是对象常量属性,Math.sin等是以命名空间组织的函数,无需也不能new Math。八个旧版常量可按用途归类:E为自然底,LN2/LN10为自然对数,LOG2E/LOG10E为换底因子,PI用于弧度与几何,SQRT2与SQRT1_2互为相关平方根量。它们是浮点近似值,不是任意精度符号常数。

数学命名空间不提供构造实例保存独立卡片。

原书依据 · 9 处

Math.abs()

Math.abs返回数值绝对值,负零会变成正零;不承担单位或输入业务校验。

数学数值结果需检查有效性

Math.abs取绝对值,Math.pow求乘方,Math.sqrt求非负平方根;这些Number运算可返回NaN或无穷而非总抛异常。负底数非整数指数不提供复数结果,超大幂可溢出。sqrt负数为NaN,不能靠pow(x,1⁄3)推广出负数立方根;原书只用正8示例,不是通用实数根函数。

数学数值结果需检查有效性保存独立卡片。

原书依据 · 3 处

Math.acos()

acos接收[-1,1]内实数,返回[0,π]弧度的反余弦,其他数值需处理NaN。

三角接口统一使用弧度

Math.sin/cos/tan输入为弧度,角度转弧度用角度×π/180;反函数输出亦为弧度。acos定义输入[-1,1]且输出[0,π],asin输出[-π/2,π/2],atan输出相应主值。不能把“正弦余弦在[-1,1]”套给正切,或将反函数结果当角度数直接使用。

三角接口统一使用弧度保存独立卡片。

原书依据 · 6 处

Math.asin()

asin输入[-1,1],输出[-π/2,π/2]弧度。

三角接口统一使用弧度关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

Math.atan()

atan返回反正切主值,输出以弧度计。

三角接口统一使用弧度关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

Math.atan2()

atan2(y,x)以坐标确定从X正轴到向量的角,范围[-π,π],参数顺序Y在前。

双参数反正切保留方向象限

atan2接受Y、X两个分量,利用各分量符号区分方向象限,不等同先计算y/x再调用atan;后者丢失象限且x=0需特殊处理。返回弧度范围[-π,π],参数顺序与习惯书写坐标(x,y)相反。坐标系Y轴方向也会影响视觉上的顺逆时针,不能直接把数学坐标描述套给屏幕。

双参数反正切保留方向象限保存独立卡片。

原书依据 · 1 处

Math.ceil()

ceil朝正无穷取整,负值向零方向不等于一律放大绝对值,floor方向相反。

取整方向不等于截断符号

ceil取不小于输入的最近整数,floor取不大于输入的最近整数,所以ceil(-1.99)为-1、floor(-1.01)为-2。round取最近整数,恰好半值时偏正无穷:-2.5到-2。三者不是通用十进制金额舍入策略,也不改变Number浮点精度,负零等特殊结果仍需按用途处理。

取整方向不等于截断符号保存独立卡片。

原书依据 · 3 处

Math.cos()

cos输入弧度,角度需乘π/180,有限有效输入的余弦在[-1,1]。

三角接口统一使用弧度关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

Math.E

E是自然对数底e,给出的十进制为近似表示。

数学命名空间不提供构造实例关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

Math.exp()

exp计算以自然底e为底的幂,与自然对数log相联系,但有限输入也可能导致溢出或下溢。

指数与对数应先明确底和域

Math.exp(x)计算e^x,Math.log(x)计算自然对数,正输入才有有限实数对数,0得到负无穷、负数得到NaN。通过LOG10E或LOG2E乘ln(x)可按换底公式得到相应对数;不要把LN10与LOG10E混用。数值结果受浮点范围和近似精度限制,不是精确符号代数。

指数与对数应先明确底和域保存独立卡片。

原书依据 · 2 处

Math.floor()

floor朝负无穷取整,负数不是简单去掉小数,四例明确与ceil/round差别。

取整方向不等于截断符号关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Math.LN10

LN10是ln(10),给出的十进制为近似表示。

数学命名空间不提供构造实例关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

Math.LN2

LN2是ln(2),给出的十进制为近似表示。

数学命名空间不提供构造实例关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

Math.log()

log为自然对数,换底可用LOG10E或LOG2E乘log(x),正常有限结果需正输入。

指数与对数应先明确底和域关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

Math.LOG10E

LOG10E是log10(e),给出的十进制为近似表示。

数学命名空间不提供构造实例关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

Math.LOG2E

LOG2E是log2(e),给出的十进制为近似表示。

数学命名空间不提供构造实例关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

Math.max()

max对数值转换后的参数取最大,无实参返回负无穷;转换结果含NaN则结果NaN。

极值函数空输入返回无穷

Math.max无实参返回-Infinity,Math.min无实参返回Infinity,不能把它们当“找到了一个业务元素”。有NaN或转成NaN的实参通常传播NaN,转换本身还可能抛错;这与空数组没有成员分别处理。函数接收可变实参,不会自动把一个数组当逐项列表,展开/借用还需考虑大量参数限制。

极值函数空输入返回无穷保存独立卡片。

原书依据 · 2 处

Math.min()

min无实参为正无穷,有NaN转换结果则NaN,与max的空输入符号相反。

极值函数空输入返回无穷关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

Math.PI

PI是圆周长/直径,给出的十进制为近似表示。

数学命名空间不提供构造实例关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

Math.pow()

pow计算底数的指定次幂,负底非整数指数不提供复数结果,指数过大可能溢出。

数学数值结果需检查有效性关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Math.random()

random给出[0,1)内伪随机Number,不由区间契约推出密码安全。

伪随机值不是安全随机保证关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

Math.round()

round取最近整数,恰好半值偏正无穷,因此-2.5变-2而非-3。

取整方向不等于截断符号关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Math.sin()

sin输入弧度,有限有效输入的正弦在[-1,1]。

三角接口统一使用弧度关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

Math.sqrt()

sqrt给非负实数平方根;用pow(x,1⁄3)的正数例不能推广为所有实数立方根。

数学数值结果需检查有效性关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Math.SQRT1_2

SQRT1_2是1/√2,给出的十进制为近似表示。

数学命名空间不提供构造实例关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

Math.SQRT2

SQRT2是√2,给出的十进制为近似表示。

数学命名空间不提供构造实例关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

Math.tan()

tan输入弧度,输出不受[-1,1]限制。

三角接口统一使用弧度关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

NaN

NaN是Number特殊值且不等自身,全局属性现行不可写不可配置;检测仍需区分转换检查和原值类型。

NaN检测要考虑隐式转换关联本项背景,实质主要讲解在对应位置。

特殊数值不总通过异常报告关联本项背景,实质主要讲解在对应位置。

原书依据 · 10 处

Number

Number带new产生包装对象,不带new作原始数值转换,静态常量与实例格式化方法应分开访问。

转换函数与包装构造分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

有限数值上界与最小正值不同

Number.MAX_VALUE是最大有限正Number,约1.79×10^308;MIN_VALUE是最小正非零Number,约5×10^-324,不是最负数,最负有限值是-MAX_VALUE。它们与NaN、正负Infinity是Number构造函数的属性,不是数字实例属性,也不能拿MAX_VALUE代替最大安全整数精度边界。

有限数值上界与最小正值不同保存独立卡片。

原书依据 · 3 处

Number.MAX_VALUE

MAX_VALUE是最大有限正数而非Infinity。

有限数值上界与最小正值不同关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Number.MIN_VALUE

MIN_VALUE是最小正非零数而非最大负值。

有限数值上界与最小正值不同关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Number.NaN

Number.NaN与全局NaN表示同一特殊数值,解析失败可返回它,但NaN比较永不命中自身。

NaN检测要考虑隐式转换关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

Number.NEGATIVE_INFINITY

负无穷是Number特殊值,溢出等操作可得到它,但对所有乘除统一按普通无穷规则描述不正确。

特殊数值不总通过异常报告关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

Number.POSITIVE_INFINITY

正无穷是Number特殊值,溢出等操作可得到它,但对所有乘除统一按普通无穷规则描述不正确。

特殊数值不总通过异常报告关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

Number.toExponential()

toExponential的digits是小数位数,省略时输出足够区分当前Number的位数;输出是字符串,舍入不修复输入的二进制浮点误差。

数值格式化先选精度含义关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

Number.toFixed()

toFixed的digits是小数位数,默认0,绝对值达到10^21会改用通常指数形式;输出是字符串,舍入不修复输入的二进制浮点误差。

数值格式化先选精度含义关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

Number.toLocaleString()

数字本地化表示依地区与环境,千位和小数符号可变,适合展示不适合无约定数据交换。

本地化字符串不等于稳定编码关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

Number.toPrecision()

toPrecision参数是有效数字数,省略走通常文本形式,极大或极小数量级可用指数形式;输出是字符串,舍入不修复输入的二进制浮点误差。

数值格式化先选精度含义关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

Number.toString()

Number.toString按指定进制产生文本,默认10,现行要求2至36而非任意返回。

数值格式化先选精度含义关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

Number.valueOf()

Number.valueOf取出数值原始值,布尔/字符串等其他接收者不因可转换就适用。

转换函数与包装构造分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

Object

Object提供普通对象构造/包装与静态属性工具,原型方法只在继承路径存在且未遮蔽时可直接调用。

原型引用与构造属性分开关联本项背景,实质主要讲解在对应位置。

转换函数与包装构造分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 15 处

Object.constructor

constructor是可被继承或覆写的属性,不能据它可靠判断数组类型,null值还会让示例直接访问失败。

构造属性不能可靠反推原型关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

Object.create()

Object.create用对象或null作新对象原型,可选描述符再定义自有属性,不调用原型对象作为构造函数。

创建对象时可直接指定原型关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

Object.defineProperties()

defineProperties批量定义属性并返回同一对象,应用多个描述符时不提供失败回滚。

批量属性定义不提供事务回滚

Object.defineProperties把描述符表用于目标对象并返回该对象;它不是事务,一些属性已成功定义后,后续定义失败可能抛错并保留前面变化。不能用“调用抛异常”推断目标完全未变。对象权限或不可配置冲突要预先设计,必要时在新对象上构建再发布,但也要明确访问器等读取副作用和发布条件。

批量属性定义不提供事务回滚保存独立卡片。

原书依据 · 1 处

Object.defineProperty()

defineProperty新增时填补缺省描述符字段,修改已有属性则保留未指定字段,不是统一赋false/null。

定义属性缺省取决于是否已存在关联本项背景,实质主要讲解在对应位置。

不可配置仍可能收紧可写权限关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

Object.freeze()

freeze不可扩展并令自有属性不可配置、自有数据属性不可写,访问器和嵌套对象仍需独立考虑。

封闭与冻结约束不同写入关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

Object.getOwnPropertyDescriptor()

getOwnPropertyDescriptor只看自有属性,返回描述特性的新普通对象;不存在返回undefined,数据与访问器描述符分开。

描述符分为数据与存取器两类关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

Object.getOwnPropertyNames()

getOwnPropertyNames取自有字符串键,包含不可枚举length,与keys的可枚举集合分开。

枚举接口覆盖不同成员集合关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Object.getPrototypeOf()

getPrototypeOf读取实际原型对象或null,不依赖可改写的constructor或prototype属性值猜测。

原型引用与构造属性分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

Object.hasOwnProperty()

hasOwnProperty检测自有属性,继承或缺失均false,与属性值真假无关。

三种属性存在性检测各自的语义边界关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Object.isExtensible()

isExtensible检查对象是否允许新增自有属性,不表示每个任意赋值都成功或已有值可改。

不可扩展只限制新增自有属性关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Object.isFrozen()

isFrozen需同时满足不可扩展、自有属性不可配置、数据属性不可写,并非已封闭或只读任一就足够。

封闭与冻结约束不同写入关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

Object.isPrototypeOf()

isPrototypeOf检测接收对象是否在目标原型链上,不仅限直接原型,不是检测自身成员或constructor。

原型链成员检测不检查自身关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Object.isSealed()

isSealed要求不可扩展且自有属性不可配置,数据值仍可能可写。

封闭与冻结约束不同写入关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

Object.keys()

keys取自有可枚举字符串键,区别names包含不可枚举项及for-in可见继承项。

枚举接口覆盖不同成员集合关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Object.preventExtensions()

preventExtensions永久禁止新增自有属性,已有可写值和原型对象自身仍可能变化。

不可扩展只限制新增自有属性关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Object.propertyIsEnumerable()

propertyIsEnumerable同时检查自有性和可枚举性,继承的可枚举属性也会返回false。

三种属性存在性检测各自的语义边界关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Object.seal()

seal不可扩展并使自有属性不可配置,仍保留数据属性原先可写性,不等于freeze。

封闭与冻结约束不同写入关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

Object.toLocaleString()

Object默认toLocaleString转调其toString,其他内置类可提供不同本地化表示。

本地化字符串不等于稳定编码关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

Object.toString()

对象的文本转换方法可定制,借用Object默认toString可见内置标签,但转换路径并不总先调toString。

借用Object原型的toString判断真实类型关联本项背景,实质主要讲解在对应位置。

对象转换方法有不同职责关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

Object.valueOf()

Object默认valueOf返回对象本身,包装类可取原始内容,自定义数值语义需明确,不能因此说包装值与原值完全等价。

对象转换方法有不同职责关联本项背景,实质主要讲解在对应位置。

原始值与对象承担不同语义关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

parseFloat()

parseFloat解析允许的数字前缀,遇不属于该数字的字符停止,成功不证明整个输入有效。

完整数值转换有意外边界关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

parseInt()

parseInt按指定2至36进制解析整数前缀,省略或0默认十进制但识别0x十六进制;不提供完整输入校验。

完整数值转换有意外边界关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

RangeError

RangeError可表示超出接口允许范围,例如负数组长度,但并非所有越界业务输入都会由语言自动检测。

异常值携带失败诊断关联本项背景,实质主要讲解在对应位置。

原书依据 · 10 处

ReferenceError

ReferenceError可报告读取无有效绑定的标识符,不同于在有效对象上读缺失属性得到undefined。

异常值携带失败诊断关联本项背景,实质主要讲解在对应位置。

原书依据 · 10 处

RegExp

RegExp可由模式文本与标志构造,复制模式与复用对象不同,旧版标志/重载限制需按版本看。

正则字面量求值具有对象身份关联本项背景,实质主要讲解在对应位置。

正则标志控制不同匹配维度关联本项背景,实质主要讲解在对应位置。

动态模式构造有双层转义边界关联本项背景,实质主要讲解在对应位置。

原书依据 · 10 处

RegExp.exec()

exec每次返回单次匹配的完整捕获/位置/输入明细,失败null;带g时在对象上维护lastIndex。

执行匹配需区分明细与布尔结果关联本项背景,实质主要讲解在对应位置。

全局匹配状态属于正则对象关联本项背景,实质主要讲解在对应位置。

空匹配循环须保证搜索前进关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

RegExp.global

global表示是否有g标志。

正则标志控制不同匹配维度关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

RegExp.ignoreCase

ignoreCase表示是否有i标志。

正则标志控制不同匹配维度关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

RegExp.lastIndex

lastIndex可写,g模式exec/test成功更新、失败归零,复用新文本需明确起点。

全局匹配状态属于正则对象关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

RegExp.source

source提供可用于表示模式的文本,不含外层斜杠或标志,也不携带lastIndex运行状态。

动态模式构造有双层转义边界关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

RegExp.test()

test返回是否存在匹配,普通正则行为可由exec非null说明,但带g的状态副作用仍在。

执行匹配需区分明细与布尔结果关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

RegExp.toString()

RegExp.toString形成模式和标志的文本表示,不能据原书排印相同的两种斜杠例判断现代转义保证。

动态模式构造有双层转义边界关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

String

String原始值不可变,构造器可包装,实例方法返回读取得到的值或变换结果,length与索引按UTF-16码元。

转换函数与包装构造分开关联本项背景,实质主要讲解在对应位置。

可索引字符串仍是不可变值关联本项背景,实质主要讲解在对应位置。

原书依据 · 11 处

旧字符串标记接口不是安全转义

旧anchor/link等造锚点,bold/italics/fixed等造样式标签,fontcolor/fontsize等插属性,big/small/blink/strike/sub/sup造其他标记。它们返回HTML文本而非DOM节点,不能视作完整HTML转义或URL校验。原书javascript:链接是演示,不宜把外部值直接放入此类构造并当安全输出;维护旧代码时识别用途,新代码按实际DOM和文本/属性契约处理。

旧字符串标记接口不是安全转义保存独立卡片。

原书依据 · 1 处

String.charAt()

charAt按码元索引取长度1字符串,越界空字符串;不保证一个索引就是完整可见字符。

字符串长度按码元计数关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

String.charCodeAt()

charCodeAt取单个16位UTF-16码元整数,越界NaN,不直接得到所有Unicode字符的码点。

字符串长度按码元计数关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

String.concat()

concat将各值转成字符串后按序连接并返回新文本,不改变原字符串。

字符串按用途读取与变换关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

String.fromCharCode()

fromCharCode是String静态方法,按16位码元组成字符串,不是任意Unicode码点的直接构造。

字符串长度按码元计数关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

String.indexOf()

字符串indexOf从归一的起点向右找文本,返回首个码元位置或-1,位置0也代表命中。

文本搜索返回位置而非真假

String.indexOf向后找子串首次位置,lastIndexOf向前找最后适合位置,索引始终从原字符串开头计数,未命中均为-1。0是合法命中,不能直接作真假判断。起点可包含自身而非严格之后/之前;负数、越界与空子串有归一规则,原文0至length−1只是常见索引范围,不是所有实参合法性约束。

文本搜索返回位置而非真假保存独立卡片。

原书依据 · 2 处

String.lastIndexOf()

lastIndexOf向左搜索但结果索引仍从开头计算,起点范围内的首遇匹配即返回。

文本搜索返回位置而非真假关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

String.length

字符串length是UTF-16码元数,空字符串没有最后一个成员,不应把length−1当始终存在的字符。

字符串长度按码元计数关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

String.localeCompare()

localeCompare按语言相关排序规则给负/零/正结果,可作为sort比较器,不能要求恰是-1/0/1。

码元排序不同于语言排序关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

String.match()

match不带g交付一项的捕获/位置明细,带g返回各完整匹配文本,未匹配两种都为null。

文本检索分位置与捕获结果关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

String.replace()

replace返回新字符串,普通文本模式只换首次,带g正则可换全部;模板与回调两种替代形式不同。

替换模板与模式引用语法不同关联本项背景,实质主要讲解在对应位置。

字符串按用途读取与变换关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

String.search()

search返回首个正则匹配位置或-1,不以g或保存的lastIndex从中间续搜。

文本检索分位置与捕获结果关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

String.slice()

slice取半开范围,负端点从尾计,省略终点到末尾,结果不修改原字符串。

字符串切片先分清端点与长度

slice(start,end)用半开端点并允许负偏移;substring(from,to)把负值归零、必要时交换两端;旧substr(start,length)第二参是长度。相似名字不代表相同边界行为,尤其负数、起点大于终点、空片段要按所用方法解释。它们取UTF-16码元片段,可能拆开代理对,均不原地修改原始文本。

字符串切片先分清端点与长度保存独立卡片。

原书依据 · 3 处

String.split()

split按文本或正则分隔成数组,limit限制结果项数而非把剩余全部装末项,正则捕获还可进入结果。

正则分隔可吸收周边空白关联本项背景,实质主要讲解在对应位置。

数组文本化会丢失结构边界关联本项背景,实质主要讲解在对应位置。

原书依据 · 7 处

String.substr()

旧substr用起点与长度,slice/substring用端点;省略长度到末尾,负起点相对尾部。

字符串切片先分清端点与长度关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

String.substring()

substring采用归一端点并在首端大于末端时交换,负值归零,不以负偏移从尾部计。

字符串切片先分清端点与长度关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

String.toLocaleLowerCase()

本地化小写转换可按地区大小写规则,不能以默认Unicode映射当所有语言都一致。

大小写转换应明确语言规则

toLowerCase/toUpperCase按默认Unicode大小写映射返回新文本,toLocale系列可采用地区相关规则,如土耳其语I的处理不同。转换不保证长度不变,也不保证往返恢复原文,不是完整的自然语言排序或无关语言的身份归一化。需要匹配或去重时先定义语言与业务等价关系,避免用一个全局大小写转换替代全部规则。

大小写转换应明确语言规则保存独立卡片。

原书依据 · 4 处

String.toLocaleUpperCase()

本地化大写,应与toUpperCase而非原文toLowerCase比较。

大小写转换应明确语言规则关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

String.toLowerCase()

默认小写变换返回新字符串。

大小写转换应明确语言规则关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

String.toString()

String的toString/valueOf取得对应原始字符串,要求字符串原始值或适合的包装接收者,并非任意值通用String转换。

转换函数与包装构造分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

String.toUpperCase()

默认大写变换返回新字符串。

大小写转换应明确语言规则关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

String.trim()

trim去掉字符串首尾空白,返回新文本,中间空白保留,不表示所有不可见字符都消失。

字符串按用途读取与变换关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

String.valueOf()

String的toString/valueOf取得对应原始字符串,要求字符串原始值或适合的包装接收者,并非任意值通用String转换。

转换函数与包装构造分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

SyntaxError

SyntaxError可由动态eval、Function或RegExp构造解析失败抛出,正常脚本自身解析失败与运行中捕获分开。

异常值携带失败诊断关联本项背景,实质主要讲解在对应位置。

原书依据 · 10 处

TypeError

TypeError报告不适用的类型或操作,包括null/undefined属性访问、非构造值new等,不是所有用户实参错误都会自动拒绝。

异常值携带失败诊断关联本项背景,实质主要讲解在对应位置。

原书依据 · 10 处

undefined

undefined是全局预定义值,当前全局属性不可写不可配置;比较null需明确严格还是宽松相等。

预定义全局名不同于保留字关联本项背景,实质主要讲解在对应位置。

严格相等保留本类型比较规则关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

unescape()

unescape配对解码旧escape的%xx/%uXXXX码元格式,与URI UTF-8解码不是任意互换。

旧转义不是UTF8百分编码关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

URIError

URIError表示URI编码中的不成对代理项或解码的错误百分/UTF-8格式,与一般网络状态错误分开。

异常值携带失败诊断关联本项背景,实质主要讲解在对应位置。

原书依据 · 10 处

第四部分 客户端JavaScript参考

客户端参考按对象名字母排序,在各父条目内集中列出常量、属性、方法和事件,查阅时须结合出版版本与前文解释。

客户端JavaScript参考

本项只有客户端参考总标题,实质条目在其后。

ApplicationCache

历史AppCache API用六状态、两方法和八类事件管理清单更新;检查、新版本下载完成与当前文档切换不是同一步。

缓存更新事件区分首次和升级关联本项背景,实质主要讲解在对应位置。

切换缓存不会重载现有代码关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

ArrayBuffer

ArrayBuffer保存字节而不按元素类型直接访问,视图提供解释,初始字节为零。

数字视图以固定元素格式解释字节关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

ArrayBufferView

ArrayBufferView是旧文档归纳视图共享属性的名称,没有可直接new的对应通用构造器,视图范围与底层缓冲分开。

构造复制与缓冲区视图分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

Attr

Attr表示元素属性节点,名字/前缀/命名空间和值分开,常规取值可直接用字符串属性API。

属性节点集合不等于子节点关联本项背景,实质主要讲解在对应位置。

命名空间与前缀不是一回事关联本项背景,实质主要讲解在对应位置。

原书依据 · 8 处

Audio

Audio工厂创建HTML音频元素,共用媒体接口,提供src可触发资源选择,不等于自动获准播放。

媒体共用接口仍保留类型差异关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

BeforeUnloadEvent

beforeunload可请求离开确认,但浏览器决定提示文本与是否展示,不能依原书自定文字保证。

离开提示不能替代状态保存关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Blob

Blob提供不可变字节数据及size/type,按API读取或传递;参考旧slice第二参长度与现行终点不同。

数据块接口连接多种二进制入口关联本项背景,实质主要讲解在对应位置。

数据块切片终点不是长度关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

BlobBuilder

BlobBuilder先append多块再getBlob是旧构造方式,现代Blob构造器接受parts,新旧接口不能混用。

合并字节块需明确编码与协议边界关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

Button

提交按钮可覆盖所关联表单的目标、方法、编码和验证设置,必须把实际提交者也纳入契约。

动作按钮应明确默认行为关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Canvas

Canvas元素管理位图尺寸、上下文获取和导出,具体2D绘制由独立且可复用的上下文对象承担。

画布元素与绘制上下文职责分开关联本项背景,实质主要讲解在对应位置。

重设画布尺寸会重置绘图状态关联本项背景,实质主要讲解在对应位置。

画布导出属于元素而非上下文关联本项背景,实质主要讲解在对应位置。

能显示跨源图不等于能读像素关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

CanvasGradient

CanvasGradient是可赋给描边/填充的渐变对象,用色标位置与颜色定义渐变,不是先绘出的一张图。

渐变对象独立于被填充形状关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

CanvasPattern

CanvasPattern是createPattern返回的图案对象,用于fillStyle/strokeStyle,本身不定义独立绘制入口。

重复图案来自可用图像源关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

CanvasRenderingContext2D

二维上下文将几何路径、绘制样式、状态栈、位图和像素缓冲分开管理:先构建路径再渲染,变换与裁剪影响相应绘制,原始像素读写另走独立规则。

路径构建后还需选择描边或填充关联本项背景,实质主要讲解在对应位置。

隐式填充闭合不改变描边路径关联本项背景,实质主要讲解在对应位置。

绕数方向决定重叠区域填充关联本项背景,实质主要讲解在对应位置。

绘图样式属于可变上下文状态关联本项背景,实质主要讲解在对应位置。

状态栈不保存路径和已有像素关联本项背景,实质主要讲解在对应位置。

绘制透明度相乘而非修改旧像素关联本项背景,实质主要讲解在对应位置。

源目标次序与合成规则共同定色关联本项背景,实质主要讲解在对应位置。

端点与折角有不同外观规则关联本项背景,实质主要讲解在对应位置。

圆心弧与切线弧使用不同参数关联本项背景,实质主要讲解在对应位置。

贝塞尔控制点不一定落在曲线上关联本项背景,实质主要讲解在对应位置。

矩形绘制与路径追加是两类操作关联本项背景,实质主要讲解在对应位置。

局部清除不等于完整重置画布关联本项背景,实质主要讲解在对应位置。

连续裁剪取交集而非替换边界关联本项背景,实质主要讲解在对应位置。

重复图案来自可用图像源关联本项背景,实质主要讲解在对应位置。

渐变对象独立于被填充形状关联本项背景,实质主要讲解在对应位置。

图片复制区分源区域与目标区域关联本项背景,实质主要讲解在对应位置。

文本绘制位置取决于对齐与基线关联本项背景,实质主要讲解在对应位置。

文本测量结果不是完整屏幕尺寸关联本项背景,实质主要讲解在对应位置。

能显示跨源图不等于能读像素关联本项背景,实质主要讲解在对应位置。

像素缓冲修改后还需写回位图关联本项背景,实质主要讲解在对应位置。

命中检测先统一画布坐标关联本项背景,实质主要讲解在对应位置。

路径命中不同于可见像素命中关联本项背景,实质主要讲解在对应位置。

仿射矩阵可组合也可直接替换关联本项背景,实质主要讲解在对应位置。

阴影偏移与物体变换分别解释关联本项背景,实质主要讲解在对应位置。

原书依据 · 53 处

ClientRect

边界矩形采用视口坐标描述边框,已取得的矩形是测量快照,不会随元素后续变化实时刷新。

几何测量结果不是实时视图关联本项背景,实质主要讲解在对应位置。

边界矩形可能包含空白区域关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

CloseEvent

WebSocket close事件用wasClean描述协议层干净关闭,不冒泡且不可取消,不能反推业务消息全部处理完。

套接字发送应等待连接可用关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Comment

Comment通过data或nodeValue访问注释文本,也提供字符数据编辑操作,节点身份与文字内容分开。

节点接口按责任区分类型关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Console

console用不同等级输出诊断,并维护计数、分组和计时状态;日志与断言提示不等于业务流程控制。

控制台诊断不会替代异常处理

console.log/info/debug/warn/error表达不同诊断等级,assert在条件假时输出断言失败信息,不替代throw或自动中止业务。dir检查对象、dirxml看节点表示、trace展示栈,各自服务观察;显示细节与对象展开依工具,不能当稳定机器交换格式或不可变状态快照。原书无正式标准属于历史情况,现已有Console标准。

控制台诊断不会替代异常处理保存独立卡片。

原书依据 · 1 处

日志分组计数计时分别有状态

group/groupCollapsed建立嵌套日志组,groupEnd结束最近组;count按标签累计,time/timeEnd按标签配对度量区间。相同标签复用可能互相干扰,分组和计时应在所需出口收尾,不能把它们混同成一次业务成功的记录。profile/profileEnd属于特定调试器分析入口,原书profle是拼写错误,不保证所有环境支持。

日志分组计数计时分别有状态保存独立卡片。

原书依据 · 1 处

ConsoleCommandLine

控制台工具注入的查询、检查与监视命令属于调试环境,不能直接复制成页面普通全局API。

调试工具命令不是页面全局接口

$0/$1可代表调试器选中节点,$与$$提供便捷查询,inspect/dir/dirxml用于查看,keys/values列数据,monitorEvents/unmonitorEvents开关观察;框架切换和profile依工具。它们不是页面脚本天然拥有的标准全局函数,也不保证与页面库的$同义。当前Chrome的$按CSS选择器取首项,$$返回数组,原书getElementById/NodeList写法不能跨版本照用。

调试工具命令不是页面全局接口保存独立卡片。

原书依据 · 1 处

CSS2Properties

CSS2Properties在本书中是CSSStyleDeclaration参考项的交叉名称。

CSSRule

CSSRule为规则类型体系的父接口,普通CSSStyleRule才有选择器与声明集合,其他类型不能按它访问。

样式载体与规则对象分开关联本项背景,实质主要讲解在对应位置。

规则选择器与声明文本分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

CSSStyleDeclaration

CSS声明对象统一管理属性名和值;内联/规则声明可写,计算样式返回结果只读,索引访问取属性名。

写入声明与查询结果分开关联本项背景,实质主要讲解在对应位置。

样式赋值需要有效语法关联本项背景,实质主要讲解在对应位置。

原书依据 · 8 处

CSSStyleSheet

样式表组织规则和所属关系,disabled控制应用,insert/delete按活动规则列表位置改变集合。

样式载体与规则对象分开关联本项背景,实质主要讲解在对应位置。

样式表启停要确认操作对象关联本项背景,实质主要讲解在对应位置。

规则增删会改变遍历边界关联本项背景,实质主要讲解在对应位置。

原书依据 · 8 处

DataTransfer

DataTransfer在拖放各阶段携带格式数据与协商动作,写入和读取时机受保护,文件与文本不是同一数据入口。

拖放传数据不只是移动元素关联本项背景,实质主要讲解在对应位置。

拖放数据访问受阶段限制关联本项背景,实质主要讲解在对应位置。

接受拖放要匹配格式和动作关联本项背景,实质主要讲解在对应位置。

原书依据 · 7 处

DataView

DataView在共享缓冲的字节范围内按显式格式读写,多字节默认大端,offset是相对当前视图的字节偏移。

多字节协议需显式选择字节序关联本项背景,实质主要讲解在对应位置。

构造复制与缓冲区视图分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

Document

Document把文档节点、结构入口、查询、节点创建、编辑流和事件组织在一起。查到节点与插入节点是不同动作;活动集合、静态快照和文档就绪也各有契约。

节点包含与类型继承分开关联本项背景,实质主要讲解在对应位置。

文档入口需要检查存在时机关联本项背景,实质主要讲解在对应位置。

兼容模式不代表文档合规关联本项背景,实质主要讲解在对应位置。

域名放宽是遗留兼容路径关联本项背景,实质主要讲解在对应位置。

文档就绪与资源完成不同关联本项背景,实质主要讲解在对应位置。

命名元素不宜隐式当全局关联本项背景,实质主要讲解在对应位置。

创建节点后还需选择插入位置关联本项背景,实质主要讲解在对应位置。

命名空间与前缀不是一回事关联本项背景,实质主要讲解在对应位置。

深克隆结构不等于复制所有状态关联本项背景,实质主要讲解在对应位置。

实时集合随文档变化关联本项背景,实质主要讲解在对应位置。

类名列表要求全部匹配关联本项背景,实质主要讲解在对应位置。

文档写入流不是普通追加接口关联本项背景,实质主要讲解在对应位置。

编辑命令按支持与状态区分关联本项背景,实质主要讲解在对应位置。

自定义事件字段不是可信证明关联本项背景,实质主要讲解在对应位置。

原书依据 · 50 处

来源字段不代表完整访问轨迹

document.referrer描述按来源策略允许暴露的上一个来源信息,可能因无来源或策略而为空字符串,不是原文null,也不是服务器报告的一份完整Referer头。document.URL表示文档当前URL,不应当作永远不变的初始下载地址;title/lastModified等又是元数据,不能替代导航历史、授权或可靠同步版本。使用前明确每个字段能证明什么。

来源字段不代表完整访问轨迹保存独立卡片。

原书依据 · 1 处

DocumentFragment

DocumentFragment暂存一组子节点,插入时移动它的子节点而不把片段节点本身装进普通文档树,之后片段变空。

片段插入会移走其子节点关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

DocumentType

DocumentType保存文档类型的名称和公共/系统标识,字段只读不等于节点不能从树中移动或删除。

节点类型帮助解释关系和值关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

DOMException

DOMException提供Web API错误名称与历史代码,错误可能发生在方法调用或属性读写时;现代原型接入Error,不能沿用旧继承描述。

平台异常名称与旧错误码分开

DOMException.name使用如IndexSizeError、SecurityError、DataCloneError的名称,不是INDEX_SIZE_ERR等旧常量拼写;code是遗留数字映射,并非每个现代名称都有非零代码。应按具体API和错误名判原因,message作诊断,不依旧码表覆盖所有错误。现行JS绑定的DOMException原型继承Error.prototype,原文非Error子类是旧版信息。

本书FileError及其NOT_FOUND/SECURITY/ABORT/NOT_READABLE/ENCODING五码是旧读取模型;现行FileReader.error通常是DOMException或null,同步读也按当前异常契约处理,不照旧FileError类名和数字硬编码所有错误。

平台异常名称与旧错误码分开保存独立卡片。

原书依据 · 2 处

DOMImplementation

DOMImplementation提供新XML/HTML文档与doctype工厂,不是把结果自动显示到窗口。

创建节点后还需选择插入位置关联本项背景,实质主要讲解在对应位置。

命名空间与前缀不是一回事关联本项背景,实质主要讲解在对应位置。

原书依据 · 11 处

DOMSettableTokenList

旧DOMSettableTokenList描述带字符串value的记号集,现代应按实际DOMTokenList及反映属性的接口,不能仅凭旧类名判断能力。

类名集合操作避免整串覆盖关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

DOMTokenList

DOMTokenList维护不重复的空白分隔记号并提供成员操作,toggle返回操作后是否包含,而不是操作前状态或是否发生改变。

类名集合操作避免整串覆盖关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

Element

Element将元素属性、子树查询、几何尺寸、标记解析、焦点/滚动与事件入口汇合。理解它要区分属性反映和原始标记、元素与一般节点、布局与滚动坐标、活动集合与查询快照,旧HTML属性清单只代表本书时代。

节点包含与类型继承分开关联本项背景,实质主要讲解在对应位置。

对象属性不总是标记字符串关联本项背景,实质主要讲解在对应位置。

元素遍历过滤文本和注释关联本项背景,实质主要讲解在对应位置。

类名集合操作避免整串覆盖关联本项背景,实质主要讲解在对应位置。

数据属性通过字符串映射关联本项背景,实质主要讲解在对应位置。

布尔属性按存在性表达开关关联本项背景,实质主要讲解在对应位置。

边界矩形可能包含空白区域关联本项背景,实质主要讲解在对应位置。

几何测量结果不是实时视图关联本项背景,实质主要讲解在对应位置。

定位参照不只由父元素决定关联本项背景,实质主要讲解在对应位置。

重写标记会替换原有节点关联本项背景,实质主要讲解在对应位置。

命名空间与前缀不是一回事关联本项背景,实质主要讲解在对应位置。

写入声明与查询结果分开关联本项背景,实质主要讲解在对应位置。

可编辑区域不等于完整编辑器关联本项背景,实质主要讲解在对应位置。

实时集合随文档变化关联本项背景,实质主要讲解在对应位置。

类名列表要求全部匹配关联本项背景,实质主要讲解在对应位置。

选择器关系决定匹配范围关联本项背景,实质主要讲解在对应位置。

创建节点后还需选择插入位置关联本项背景,实质主要讲解在对应位置。

自定义事件字段不是可信证明关联本项背景,实质主要讲解在对应位置。

变化事件与每次编辑不同关联本项背景,实质主要讲解在对应位置。

原书依据 · 65 处

ErrorEvent

Worker错误在内部全局作用域与外部Worker句柄之间报告,取消默认报告不等于修复失败,处理器类型不同也有返回约定差别。

全局错误返回值有特殊约定关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

Event

Event参考把标准基类、鼠标键盘子类、旧IE和jQuery包装的字段并列说明;使用时先确定事件家族与注册方式,再解释坐标、默认动作、传播、时间基准和合成输入。

事件对象记录一次分派的信息关联本项背景,实质主要讲解在对应位置。

事件传播的三阶段模型与事件委托关联本项背景,实质主要讲解在对应位置。

监听接收值不同于原始目标关联本项背景,实质主要讲解在对应位置。

阻止默认与停止传播分开关联本项背景,实质主要讲解在对应位置。

返回假值不总能取消事件关联本项背景,实质主要讲解在对应位置。

拖动坐标必须使用同一参照关联本项背景,实质主要讲解在对应位置。

拖放数据访问受阶段限制关联本项背景,实质主要讲解在对应位置。

快捷键不等于输入字符编码关联本项背景,实质主要讲解在对应位置。

历史输入事件提案需标版本关联本项背景,实质主要讲解在对应位置。

滚轮增量先解释其单位关联本项背景,实质主要讲解在对应位置。

自定义事件字段不是可信证明关联本项背景,实质主要讲解在对应位置。

原书依据 · 34 处

鼠标变化键与按住状态不同

MouseEvent.button描述该次变化的按键,标准0/1/2通常为主/中/次键,不是按住键位掩码;buttons描述当前按住组合。旧IE button掩码与jQuery which编码又不同,不能在mousemove里用button直接推断完整按下状态。左右键也可能随系统主次配置变化,应以主/次语义理解。

鼠标变化键与按住状态不同保存独立卡片。

原书依据 · 1 处

事件时间戳需明确计时基准

Event.timeStamp不应一律传给Date构造:现代原生事件常采用相对相关全局时间原点的高精度毫秒,旧浏览器和jQuery包装可能采用不同基准。比较/日志需要先明确来源、单位与原点,跨窗口/包装事件不盲混。包装创建时补时间戳也不等于真实硬件事件发生时间。

事件时间戳需明确计时基准保存独立卡片。

原书依据 · 1 处

EventSource

EventSource用HTTP接收服务器文本事件,有连接/重连/关闭状态,普通message以外的自定义类型需另注册监听。

事件流按类型分派完整消息关联本项背景,实质主要讲解在对应位置。

重连需要关闭与恢复契约关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

EventTarget

EventTarget注册/删除监听并同步分发事件,监听身份、类型与capture须匹配;dispatch返回的是取消结果而非业务处理成功。

属性式注册与监听器式注册的本质差异关联本项背景,实质主要讲解在对应位置。

监听器注销需要保留函数身份关联本项背景,实质主要讲解在对应位置。

阻止默认与停止传播分开关联本项背景,实质主要讲解在对应位置。

旧事件适配不只替换方法名关联本项背景,实质主要讲解在对应位置。

原书依据 · 12 处

FieldSet

fieldset可把一组表单控件整体禁用,elements提供分组控件集合;禁用传播有首legend子树例外。

字段集禁用有首图例例外

fieldset.disabled使其后代表单控件受禁用约束,但首个legend子元素的后代有例外,可用于保留组开关。disabled不等于从DOM删除或视觉隐藏,控件可交互性/是否进入提交数据需分别按表单规则处理。elements是分组集合,不能把fieldset看成拥有每种输入类型全部行为的单一控件。

字段集禁用有首图例例外保存独立卡片。

原书依据 · 1 处

File

File继承Blob并加文件名与修改时间元数据,用户文件选择/拖放或授权入口给对象,不提供任意本机路径读取。

文件对象不等于任意本机路径关联本项背景,实质主要讲解在对应位置。

文件名类型与修改时间只是元数据关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

FileError

FileError是早期文件读取错误模型,异步读通过error属性、同步读通过异常报告,但现代应使用相应DOMException错误名。

平台异常名称与旧错误码分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

FileReader

FileReader用状态、结果和事件异步交付数据,DONE包括成功/失败,progress不是部分结果可用保证;abort与读取重入也有条件。

读取器按结果类型启动异步读取关联本项背景,实质主要讲解在对应位置。

文本读取仍需确定编码与输出方式关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

FileReaderSync

FileReaderSync在允许的Worker作用域中同步返回Blob内容或抛错,不能直接用在窗口主线程,其格式选择对应异步读取。

读取器按结果类型启动异步读取关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Form

Form把关联控件、提交目标/编码、验证及提交/重置入口组织在一起;提交动作和事件路径不同,控件名访问也有冲突风险。

表单控件集合可能返回同名组关联本项背景,实质主要讲解在对应位置。

控件值与所属表单按接口解释关联本项背景,实质主要讲解在对应位置。

提交与重置事件路径不同关联本项背景,实质主要讲解在对应位置。

原书依据 · 10 处

FormControl

FormControl是概括多种控件共性的文档接口,具体控件仍有差别;验证资格、有效状态和自定义错误需分别处理。

控件值与所属表单按接口解释关联本项背景,实质主要讲解在对应位置。

历史输入事件提案需标版本关联本项背景,实质主要讲解在对应位置。

原书依据 · 7 处

自定义错误清空不代表全部有效

setCustomValidity非空字符串设置自定义错误,空串只清除此错误;required、pattern、范围或类型等其他约束仍可能失败。willValidate表示是否参与约束验证,validity描述各失败原因,validationMessage供当前报告,checkValidity返回该验证范围是否通过并可能触发invalid。有效性通过不等于业务规则、服务端授权或所有数据都可信。

自定义错误清空不代表全部有效保存独立卡片。

原书依据 · 2 处

FormData

FormData按multipart/form-data组织名值和Blob,append后交给XHR发送,编码类型不限定HTTP必须PUT。

序列化格式必须与服务端约定关联本项背景,实质主要讲解在对应位置。

文件对象不等于任意本机路径关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

FormValidity

ValidityState(本书叫FormValidity)是控件约束状态的实时视图,valid为所有适用错误标志均不成立,不等于一次检查快照。

自定义错误清空不代表全部有效关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

Geocoordinates

坐标报告将经纬度、水平/高度精度、海拔、速度和方向分开,单位和缺失值不能混用。

可选位置数据需区分零和缺失关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

Geolocation

一次定位回调交付结果,持续监视返回取消句柄,精度提示/缓存年龄/等待超时是三个独立约束。

定位订阅需要保存取消句柄关联本项背景,实质主要讲解在对应位置。

定位许可不保证获取成功关联本项背景,实质主要讲解在对应位置。

精度缓存与超时分别约束定位关联本项背景,实质主要讲解在对应位置。

原书依据 · 8 处

GeolocationError

定位失败分权限/不可用/超时三类,调试message不能当稳定用户提示或机器判断键。

定位许可不保证获取成功关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Geoposition

位置报告用coords给坐标、timestamp给此次位置的时间,时间戳为纪元毫秒而非与普通Event.timeStamp天然同基准。

精度缓存与超时分别约束定位关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

HashChangeEvent

hashchange给出完整新旧URL,不只是hash文本;实际片段变更与pushState/replaceState历史操作有不同事件路径。

片段状态与历史对象各有恢复范围关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

History

History提供遍历与条目状态写入,length不暴露当前索引或完整URL列表,保存状态和地址也不是永久外部存档。

历史条目可以表示应用状态关联本项背景,实质主要讲解在对应位置。

结构化复制不同于JSON往返关联本项背景,实质主要讲解在对应位置。

推入历史不会自动恢复界面关联本项背景,实质主要讲解在对应位置。

历史回退只恢复应用自管状态关联本项背景,实质主要讲解在对应位置。

原书依据 · 10 处

HTMLCollection

HTMLCollection按索引或name/id查询元素,通常为活动只读视图,item越界null不同于方括号未命中undefined。

实时集合随文档变化关联本项背景,实质主要讲解在对应位置。

表单控件集合可能返回同名组关联本项背景,实质主要讲解在对应位置。

原书依据 · 10 处

HTMLDocument

HTMLDocument在本书参考组织中并入Document。

HTMLElement

HTMLElement在本书参考组织中并入Element,但实际类型仍有HTML/通用元素职责差别。

HTMLFormControlsCollection

HTMLFormControlsCollection可对同名控件返回RadioNodeList式集合,其value专门反映选中单选项,不是任意控件值自动拼接。

表单控件集合可能返回同名组关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

HTMLOptionsCollection

选项集合的可写长度、增删和selectedIndex会改变真实select后代,普通namedItem语义不能套本书旧多项返回说明。

选项集合修改会改变文档关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

IFrame

iframe元素节点与它承载的窗口/文档是不同对象,访问仍受来源和沙箱限制;src与srcdoc分别给地址和标记内容。

窗口关系不等于文档访问权关联本项背景,实质主要讲解在对应位置。

框架隔离不代替内容安全处理关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

沙箱允许标记是在放宽限制

iframe sandbox空值启用一组限制,allow-scripts/allow-forms/allow-same-origin等按项恢复相应能力,原文把allow项说成增加限制方向错误。allow-forms涉及表单能力,不是禁止表单显示。允许脚本且保留真实同源身份时,嵌入的同源脚本可能移除属性再重载,因此应按内容信任和实际来源设计,不能仅见sandbox属性就推断隔离成立。

沙箱允许标记是在放宽限制保存独立卡片。

原书依据 · 1 处

Image

Image工厂创建img节点,设置src启动资源选择,显示还需插入和可用资源;complete和尺寸不能单独证明成功。

预请求图片不保证立即可显示关联本项背景,实质主要讲解在对应位置。

创建节点后还需选择插入位置关联本项背景,实质主要讲解在对应位置。

原书依据 · 8 处

ImageData

ImageData以行优先分量缓冲表示像素,data只读引用仍可写分量,改缓冲还需putImageData发布到画布。

像素缓冲修改后还需写回位图关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Input

input按type改变功能,初始/当前状态、提交值、格式约束、选区与步进方法不能在所有类型上一概使用。

控件值与所属表单按接口解释关联本项背景,实质主要讲解在对应位置。

选中状态与提交值分开关联本项背景,实质主要讲解在对应位置。

文件选择不能靠任意路径赋值关联本项背景,实质主要讲解在对应位置。

动作按钮应明确默认行为关联本项背景,实质主要讲解在对应位置。

选区文本与表单内部选择分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 17 处

输入提示和有效性约束分开

placeholder、size、datalist和accept主要提供提示、展示或选择引导,不能代替required、pattern、min/max/step等适用约束,也不能代替服务端校验。maxLength不同于输入框显示宽度;pattern是全值匹配而非找任意子串,空的可选输入和不适用类型需按控件规则判断。占位文是否在聚焦时消失依实际内容/呈现,不能按旧文作固定契约。

输入提示和有效性约束分开保存独立卡片。

原书依据 · 1 处

jQuery

jQuery1.4参考将工厂、选择器、集合、属性/样式/数据、DOM增删、事件、队列动画、Ajax和工具函数组成一套按集合操作的接口。首先分清静态函数与实例方法、getter与setter、原生对象与包装返回,再结合版本与各子系统的完成/失败语义。

重载入口先区分参数形态关联本项背景,实质主要讲解在对应位置。

集合操作把查询与批处理连接关联本项背景,实质主要讲解在对应位置。

包装对象与原生元素不同关联本项背景,实质主要讲解在对应位置。

集合遍历回调不等于数组遍历关联本项背景,实质主要讲解在对应位置。

映射集合不保证一进一出关联本项背景,实质主要讲解在对应位置。

重载索引查询要认清搜索方向关联本项背景,实质主要讲解在对应位置。

集合谓词不等于逐项断言关联本项背景,实质主要讲解在对应位置。

库伪类不能直接当标准CSS关联本项背景,实质主要讲解在对应位置。

可见过滤不等于用户看得见关联本项背景,实质主要讲解在对应位置。

集合过滤方向决定保留项关联本项背景,实质主要讲解在对应位置。

关系遍历要明确边界与顺序关联本项背景,实质主要讲解在对应位置。

选区栈回退不撤销文档修改关联本项背景,实质主要讲解在对应位置。

旧属性接口需要版本前提关联本项背景,实质主要讲解在对应位置。

样式包装不修复错误属性名关联本项背景,实质主要讲解在对应位置。

元素数据缓存有独立生命周期关联本项背景,实质主要讲解在对应位置。

位置包装仍需辨明参照系关联本项背景,实质主要讲解在对应位置。

尺寸包装先分盒层与版本关联本项背景,实质主要讲解在对应位置。

表单值包装仍要看控件类型关联本项背景,实质主要讲解在对应位置。

成对插入接口有不同返回值关联本项背景,实质主要讲解在对应位置。

包装接口决定新增层级范围关联本项背景,实质主要讲解在对应位置。

移出文档与清理数据分开关联本项背景,实质主要讲解在对应位置。

文本输出要区分节点与包装方法关联本项背景,实质主要讲解在对应位置。

事件快捷写法受版本约束关联本项背景,实质主要讲解在对应位置。

注册时数据不同于触发时参数关联本项背景,实质主要讲解在对应位置。

一次监听按元素事件分别计算关联本项背景,实质主要讲解在对应位置。

委托按传播路径匹配后代关联本项背景,实质主要讲解在对应位置。

旧实时接口依赖选择上下文关联本项背景,实质主要讲解在对应位置。

手动触发不等于真实用户动作关联本项背景,实质主要讲解在对应位置。

局部触发不执行原生默认动作关联本项背景,实质主要讲解在对应位置。

事件命名空间支持定向管理关联本项背景,实质主要讲解在对应位置。

动画队列按元素独立串行关联本项背景,实质主要讲解在对应位置。

动画目标与执行选项分开关联本项背景,实质主要讲解在对应位置。

禁用动画保留最终状态变化关联本项背景,实质主要讲解在对应位置。

停止动画需选择队列与终值关联本项背景,实质主要讲解在对应位置。

延迟队列不保证计时器被取消关联本项背景,实质主要讲解在对应位置。

片段加载需分开地址与选择器关联本项背景,实质主要讲解在对应位置。

序列化格式必须与服务端约定关联本项背景,实质主要讲解在对应位置。

响应处理方式决定执行边界关联本项背景,实质主要讲解在对应位置。

请求格式与响应类型是两方向关联本项背景,实质主要讲解在对应位置。

请求默认配置会扩大影响范围关联本项背景,实质主要讲解在对应位置。

请求回调与返回接口依版本变化关联本项背景,实质主要讲解在对应位置。

全局请求事件也有版本边界关联本项背景,实质主要讲解在对应位置。

工具遍历需核对成员和参数关联本项背景,实质主要讲解在对应位置。

合并对象需区分空源与空值关联本项背景,实质主要讲解在对应位置。

对象判定只回答特定谓词关联本项背景,实质主要讲解在对应位置。

类数组转换有特殊输入边界关联本项背景,实质主要讲解在对应位置。

局部别名减少全局名字竞争关联本项背景,实质主要讲解在对应位置。

代理函数共享库监听身份关联本项背景,实质主要讲解在对应位置。

原书依据 · 104 处

替换抛错会改变控制流程

原书建议调试时把jQuery.error替成alert,但1.4.2原函数会throw消息,alert只显示并正常返回。调用方原本依赖抛错中止的路径可能继续执行,导致无效状态传播。观察错误应保留所需失败完成语义,例如记录后继续抛出,而不是只保留可见消息;不能把日志出现当原有失败控制还存在。

替换抛错会改变控制流程保存独立卡片。

原书依据 · 1 处

KeyEvent

KeyEvent仅交叉指向Event,没有独立展开。

Label

标签把说明文字与特定可标记控件建立关联;隐式嵌套与for显式关联是两种方式。

标签关联取决于目标控件

label的for对应目标控件ID;未指定for时,关联树顺序中首个可标记后代,不限直接子元素。control可为空,不能按标签所在视觉位置猜目标。当前label.form来自关联控件的form,并非一律取包围label的祖先form;原书把label自身form属性作为关联入口的说明不能直接沿用。

标签关联取决于目标控件保存独立卡片。

原书依据 · 1 处

Link

参考将导航链接与外部资源链接集中说明,接口能力仍按元素类型区分。

地址分量保留各自边界关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

链接类型决定可用接口

a与area提供超链接URL分量,link表示外部资源关系;它们不是一个统一Link构造类型。样式表sheet可能为空,disabled须放在样式表情境解释。当前relList不只限样式表link,a与area也有;a的text不能不加区分套给area。共同的href名字不保证对象具有相同导航、文本与样式控制接口。

链接类型决定可用接口保存独立卡片。

原书依据 · 1 处

Location

Location把地址分解和导航操作结合,赋值不是单纯修改普通字符串。

地址分量保留各自边界关联本项背景,实质主要讲解在对应位置。

替换导航避免返回重定向页关联本项背景,实质主要讲解在对应位置。

只读地址不等于首次快照关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

MediaElement

媒体资源获取、播放准备和播放控制是不同维度;事件观察须回读相应状态。

媒体共用接口仍保留类型差异关联本项背景,实质主要讲解在对应位置。

媒体就绪不表示全部下载关联本项背景,实质主要讲解在对应位置。

播放缓冲和可寻址范围分开关联本项背景,实质主要讲解在对应位置。

播放位置速率与静音分开控制关联本项背景,实质主要讲解在对应位置。

预加载提示不保证资源下载量关联本项背景,实质主要讲解在对应位置。

媒体事件应结合当前状态解释关联本项背景,实质主要讲解在对应位置。

重选媒体源会重置加载过程关联本项背景,实质主要讲解在对应位置。

播放请求可能被策略拒绝关联本项背景,实质主要讲解在对应位置。

类型探测只表示解码支持预估关联本项背景,实质主要讲解在对应位置。

原书依据 · 21 处

MediaError

MediaError以四类错误解释失败阶段,而非一个通用失败布尔值。

媒体错误码区分失败阶段

媒体元素error无错时为空,有错后读取code可区分获取中止、网络失败、解码失败与源不受支持。DECODE指解码媒体失败,不能误译为脚本编码字符错误;错误类别也不直接说明业务是否完成或应无限重试。

媒体错误码区分失败阶段保存独立卡片。

原书依据 · 1 处

MessageChannel

通道创建一对对称互联的端口,移交一个端口可将后续消息限定到特定通信链路。

消息通道由对称端口组成

MessageChannel创建port1与port2,在一端postMessage会向另一端异步发送。将端口转移给窗口或Worker建立特定通道,不等于给普通对象复制一个仍可两边使用的句柄,也不自行提供加密或业务鉴权。

结构图:

classDiagram
class MessageChannel {
 +constructor()
 +MessagePort port1
 +MessagePort port2
}
class EventTarget
class MessagePort {
 +postMessage(message, transfer) undefined
 +start() undefined
 +close() undefined
}
EventTarget <|-- MessagePort
MessageChannel *-- MessagePort : 两个互联端口

签名按当前接口简记transfer可选,端口的继承与通道持有关系分别表示。

消息通道由对称端口组成保存独立卡片。

原书依据 · 3 处

MessageEvent

MessageEvent是多种通信机制共用的事件外壳,各API的数据契约仍不同。

共享消息事件不统一数据契约

MessageEvent.data的允许形态取决于发送API:窗口和端口使用结构化复制,WebSocket按文本或二进制交付,SSE提供文本。不能从共同onmessage推导所有通道都能发送任意可复制对象。origin是序列化源而非完整路径URL,source和ports按来源机制解释,lastEventId承接SSE事件ID;普通平台消息通知不靠冒泡或可取消默认动作完成业务。

共享消息事件不统一数据契约保存独立卡片。

原书依据 · 2 处

MessagePort

端口先准备接收处理,再启动消息队列,异步发送与收到后的处理结果是两层事情。

消息通道由对称端口组成关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

端口监听需要启动消息队列

MessagePort最初暂停分派队列,用addEventListener注册后还需start;设置onmessage会隐式启动。postMessage将受支持数据发往互联端口,不向当前端口自己回调,发送返回不保证接收业务成功。close断开连接,需由协议另行表达完成、失败或确认;这里没有Window.postMessage的targetOrigin参数。

端口监听需要启动消息队列保存独立卡片。

原书依据 · 1 处

Meter

标尺表示已知范围中的当前测量值,并用区间和最优值表达评价。

标尺展示有界测量值

meter用min/max界定范围,value给当前读数,low/high与optimum决定怎样理解区间。默认范围0到1;它表达测量值在范围中的位置,不等同任务完成进度。数值DOM属性与HTML字符串属性是反射关系,labels用于关联说明,书中form字段不直接当当前标准保证。

标尺展示有界测量值保存独立卡片。

原书依据 · 1 处

MouseEvent

MouseEvent仅指向Event,具体鼠标字段已在事件参考解释。

Navigator

浏览器描述、联网估计、处理器注册和旧存储提案具有不同用途,不能由描述字符串推导能力。

浏览器嗅探只宜限定缺陷关联本项背景,实质主要讲解在对应位置。

能力检测围绕实际依赖关联本项背景,实质主要讲解在对应位置。

联网标志不能证明服务可达关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

旧存储让步不是当前锁接口

书内yieldForStorageUpdates描述早期存储互斥提案,不能作为当前localStorage或cookie读改写的锁接口使用。跨窗口共享存储时,单次读写可用也不代表复合检查再更新原子化;若需一致性,应选择有明确事务或协调契约的机制。

旧存储让步不是当前锁接口保存独立卡片。

原书依据 · 1 处

Node

Node提供类型、树遍历、文本与结构修改的共同契约,位置比较返回组合位掩码。

节点接口按责任区分类型关联本项背景,实质主要讲解在对应位置。

节点遍历要考虑非元素节点关联本项背景,实质主要讲解在对应位置。

节点类型帮助解释关系和值关联本项背景,实质主要讲解在对应位置。

递归聚合只保留指定节点文本关联本项背景,实质主要讲解在对应位置。

插入已有节点会移动它关联本项背景,实质主要讲解在对应位置。

深克隆结构不等于复制所有状态关联本项背景,实质主要讲解在对应位置。

片段插入会移走其子节点关联本项背景,实质主要讲解在对应位置。

删除替换在父节点上执行关联本项背景,实质主要讲解在对应位置。

命名空间与前缀不是一回事关联本项背景,实质主要讲解在对应位置。

原书依据 · 28 处

节点位置比较以对方为参照

a.compareDocumentPosition(b)描述b相对a的位置:PRECEDING/FOLLOWING表示b在前/后;CONTAINS表示b包含a,CONTAINED_BY表示b被a包含,并与顺序位组合。相同节点返回0;断连按树根判断,不只看ownerDocument。当前还有IMPLEMENTATION_SPECIFIC位,不能将未列出的位当错误。

节点位置比较以对方为参照保存独立卡片。

原书依据 · 1 处

文本归一化不合并任意节点

Node.normalize在子树中移除空Text并合并相邻Text,不能把原书“合并相邻节点”读成把相邻元素或注释也合并。它整理文本节点结构,不做Unicode规范化;节点数量/身份可能变化,持有旧文本节点引用时要考虑这一点。

文本归一化不合并任意节点保存独立卡片。

原书依据 · 1 处

NodeList

NodeList是节点列表接口,取值边界与是否实时由具体来源决定。

实时集合随文档变化关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

节点列表索引越界不含空节点

NodeList有效范围内提供节点,item越界返回null,方括号越界通常undefined;这不等于列表内存在null占位。length与数字索引不使它成为真正Array,实时列表在遍历删除时会改变后续索引;需要固定目标时先取快照。

节点列表索引越界不含空节点保存独立卡片。

原书依据 · 1 处

Option

选项的默认选择、当前选择、显示文字、提交值和实际禁用状态是不同维度。

选中状态与提交值分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

选项禁用属性不涵盖组状态

option.disabled反射自身disabled标记,外层optgroup可使选项实际禁用却不把该属性改为true。判断是否可用要按关联上下文,且禁用并不阻止脚本修改selected。文本、label、value也分开:显式value决定提交值,缺少时按选项文本算法取值,不把原始textContent无条件当最终值。

选项禁用属性不涵盖组状态保存独立卡片。

原书依据 · 1 处

Output

output表示计算结果,可关联输入元素并保留重置用默认内容。

结果元素关联不执行计算

output.htmlFor是关联输入ID的标记集合,不会自动订阅并计算结果。value显示当前结果,defaultValue服务于重置;当前接口为DOMTokenList而非独立DOMSettableTokenList类。它可与form关联供脚本引用,但结果值不因关联就作为表单提交字段。

结果元素关联不执行计算保存独立卡片。

原书依据 · 1 处

PageTransitionEvent

页面重新加载与从保留的会话历史恢复需要不同的更新时机。

页面隐藏不保证保存到缓存

pageshow.persisted区分恢复旧页面与新加载;pagehide.persisted表示该页面可能被保留复用,并非书中所说恒为true,也不保证以后一定恢复。应据实际事件更新状态,不能只靠首次load准备全部逻辑。当前规范为历史兼容把这些事件的bubbles/cancelable置true,但取消没有实际效果,也不能越过Window冒泡;不能照书把字段值一概写false。

页面隐藏不保证保存到缓存保存独立卡片。

原书依据 · 2 处

PopStateEvent

popstate把激活历史条目中保存的状态副本交回应用,由应用恢复界面。

历史条目可以表示应用状态关联本项背景,实质主要讲解在对应位置。

推入历史不会自动恢复界面关联本项背景,实质主要讲解在对应位置。

原书依据 · 6 处

ProcessingInstruction

XML处理指令由目标名与数据组成,不是进度事件。

处理指令区分目标与数据

ProcessingInstruction表示XML处理指令,target指定处理器目标,data保存目标后到结束标记前的内容。它是节点而非可见元素或下载进度;书中标题“进度指示”易误导。普通HTML解析不会据此产生同一种XML处理指令节点,应用若显式创建节点则另按DOM接口处理。

处理指令区分目标与数据保存独立卡片。

原书依据 · 1 处

Progress

progress表达任务已完成量,未知总量时以不确定状态显示。

进度条区分确定与未知总量

progress的value/max表达可计算的完成比例;缺少value标记时为不确定状态,position返回-1。要切回未知进度应移除value属性,赋0会变成确定且零进度。它展示任务进展,不等于meter的测量值,也不保证某种固定动画。旧form字段不当当前接口保证。

进度条区分确定与未知总量保存独立卡片。

原书依据 · 2 处

ProgressEvent

ProgressEvent传递操作已处理量与可计算总量;不同API的完成语义仍需分别解释。

进度百分比需要可计算总量关联本项背景,实质主要讲解在对应位置。

生命周期完成不等于操作成功关联本项背景,实质主要讲解在对应位置。

进度条区分确定与未知总量关联本项背景,实质主要讲解在对应位置。

原书依据 · 10 处

Screen

Screen描述显示器可用与总体区域,而非当前页面内容区域。

屏幕尺寸不等于页面视口关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Script

script元素内容与加载策略影响脚本准备和执行,已执行元素改文本不重新执行。

动态插入脚本也会执行关联本项背景,实质主要讲解在对应位置。

脚本加载策略改变执行顺序关联本项背景,实质主要讲解在对应位置。

脚本类型决定内容处理关联本项背景,实质主要讲解在对应位置。

原书依据 · 9 处

Select

选择列表把选项集合、选择状态和视觉呈现分开,多选不能只看首个索引。

选项集合修改会改变文档关联本项背景,实质主要讲解在对应位置。

选中状态与提交值分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 7 处

多选状态不能只读首个索引

multiple列表可以有多个选项选中,selectedIndex只返回第一个;读取所有选择可遍历selectedOptions或检查各option.selected。显示尺寸与选择数量是不同维度;书中size默认1/4是显示算法,不能当缺少属性时size这个DOM getter的返回保证。

多选状态不能只读首个索引保存独立卡片。

原书依据 · 1 处

Storage

Storage以字符串键值提供读取、覆盖、删除与清空,命名属性语法不改变数据契约。

存储范围由源与会话共同决定关联本项背景,实质主要讲解在对应位置。

保存前需区分缺失与空字符串关联本项背景,实质主要讲解在对应位置。

存储方法明确读写与删除范围关联本项背景,实质主要讲解在对应位置。

原书依据 · 8 处

StorageEvent

存储事件通知共享同一存储区的其他窗口,携带新旧值、键与来源地址。

存储变化通知其他共享窗口关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

Style

style元素关联样式表,字段反射与样式表控制是不同层次。

样式表启停要确认操作对象关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

Table

表格提供标题、头体尾分区和整表行集合,并用便利方法管理其结构。

表格排序先固定目标与比较契约关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

表格便利接口保留分区边界

createCaption/createTHead/createTFoot在已有对应项时返回它,createTBody则新建分区。insertRow返回新行,行索引按表格行集合解释,不能简单当原始源码次序;当前集合先thead、再表体行、最后tfoot。空表插行可建立tbody,便利方法仍修改真实节点树。

表格便利接口保留分区边界保存独立卡片。

原书依据 · 2 处

TableCell

单元格位置与跨行跨列数分别描述行内索引和布局跨度。

单元格索引不等于视觉列号

cellIndex给单元格在所属行的顺序,colSpan/rowSpan控制网格覆盖,存在跨度时索引不等于视觉列号。HTML属性应拼colspan,原书conspan有误;td与th都属于单元格接口。

单元格索引不等于视觉列号保存独立卡片。

原书依据 · 2 处

TableRow

行接口提供本行单元格集合及整表、分区两种索引。

单元格索引不等于视觉列号关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

表格行索引要明确集合

rowIndex相对整表,sectionRowIndex相对所属分区,cells相对当前行。insertCell插入td并返回它,索引省略/-1在末尾;若需要th,须显式创建正确元素,不能把便利接口当所有单元格类型工厂。

表格行索引要明确集合保存独立卡片。

原书依据 · 2 处

TableSection

表格分区是thead/tbody/tfoot,其rows和插删索引局限在该部分。

表格行索引要明确集合关联本项背景,实质主要讲解在对应位置。

表格便利接口保留分区边界关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

Text

Text既有字符数据操作,也支持把一个文本节点拆成相邻节点,文本内容与树结构是两层状态。

文本拆分会保留原节点前段

splitText(offset)把原节点改为前半,创建并返回后半;有父节点时后半紧随原节点插入,无父节点时不凭空连接。偏移以DOM字符串码元计,可能切开代理对,不能当用户可见字符边界。wholeText聚合相邻Text,normalize处理树结构而不是Unicode文字规范化。

文本拆分会保留原节点前段保存独立卡片。

原书依据 · 1 处

字符数据修改需要边界检查

append/insert/delete/replaceData修改节点数据,substringData只返回子串;count越过末端可截到结尾,但offset越过长度不能据此认定也自动截断。length计UTF-16码元,不是字素数量;旧replaceWholeText不当当前通用接口,性能快慢未实测。

字符数据修改需要边界检查保存独立卡片。

原书依据 · 1 处

TextArea

多行文本控件区分默认内容与当前value,选择范围仍按半开索引表达。

选区文本与表单内部选择分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

文本控件默认值与当前值分开

textarea.defaultValue对应初始文本内容供表单重置使用,value表示当前编辑值;用户编辑后改初始文本不应直接当正在编辑的值。cols/rows控制呈现尺寸,不等同maxLength约束;textLength和选择偏移按字符串码元处理。

文本控件默认值与当前值分开保存独立卡片。

原书依据 · 1 处

TextMetrics

TextMetrics为测量结果,不是可见文本包围盒的统一保证。

文本测量结果不是完整屏幕尺寸关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

TimeRanges

TimeRanges保存有序规范化的不相交时间区间,不能只看最后一个终点当连续缓存。

播放缓冲和可寻址范围分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

TypedArray

类型化数组将字节缓冲区解释为特定数值元素,构造复制与建立共享视图不同。

数字视图以固定元素格式解释字节关联本项背景,实质主要讲解在对应位置。

构造复制与缓冲区视图分开关联本项背景,实质主要讲解在对应位置。

原书依据 · 7 处

URL

对象URL以临时地址引用Blob数据,创建和撤销的生命周期须明确。

对象URL引用数据而非编码数据关联本项背景,实质主要讲解在对应位置。

对象URL撤销要匹配使用寿命关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

Video

视频布局尺寸、固有尺寸和海报图是独立呈现维度。

媒体共用接口仍保留类型差异关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

视频固有尺寸不同于布局尺寸

videoWidth/videoHeight为视频固有尺寸的CSS像素值,尚无元数据时可为0;width/height标记提供呈现尺寸,不能据此证明解码帧实际像素或最终布局尺寸。poster指定播放前显示图,书内audio token字段为历史提案,默认静音采用muted相关接口。

视频固有尺寸不同于布局尺寸保存独立卡片。

原书依据 · 1 处

WebSocket

套接字连接异步建立,发送和缓冲不等于远端处理结果。

双向消息通道仍需应用协议关联本项背景,实质主要讲解在对应位置。

套接字发送应等待连接可用关联本项背景,实质主要讲解在对应位置。

共享消息事件不统一数据契约关联本项背景,实质主要讲解在对应位置。

原书依据 · 7 处

Window

Window汇集窗口关系、文档地址、全局宿主服务和事件;共享全局入口不意味着拥有无限浏览器权限。

全局对象连接标准与宿主入口关联本项背景,实质主要讲解在对应位置。

命名元素不宜隐式当全局关联本项背景,实质主要讲解在对应位置。

窗口关系不等于文档访问权关联本项背景,实质主要讲解在对应位置。

框架元素与框架窗口分开关联本项背景,实质主要讲解在对应位置。

窗口索引不是元素数组关联本项背景,实质主要讲解在对应位置。

窗口名称选择目标而非授权关联本项背景,实质主要讲解在对应位置。

打开窗口不保证得到可用引用关联本项背景,实质主要讲解在对应位置。

关闭窗口与持有引用不同关联本项背景,实质主要讲解在对应位置。

存储范围由源与会话共同决定关联本项背景,实质主要讲解在对应位置。

屏幕尺寸不等于页面视口关联本项背景,实质主要讲解在对应位置。

解析样式不保证全是像素数关联本项背景,实质主要讲解在对应位置。

滚动目标与滚动增量分开关联本项背景,实质主要讲解在对应位置。

计时器字符串会再次求值关联本项背景,实质主要讲解在对应位置。

组合定时器先核对首次触发关联本项背景,实质主要讲解在对应位置。

对话框取消不是空字符串关联本项背景,实质主要讲解在对应位置。

全局错误观察不等于恢复关联本项背景,实质主要讲解在对应位置。

发送目标约束与来源校验分开关联本项背景,实质主要讲解在对应位置。

页面隐藏不保证保存到缓存关联本项背景,实质主要讲解在对应位置。

原书依据 · 44 处

基数编码处理字节而非任意文本

atob把Base64解码为每码元表示一字节的二进制字符串,btoa执行反方向。它们不是任意Unicode文本的自动编码器,文本应先用约定编码转换为字节,再编码Base64;Base64也不提供加密或安全转义。

基数编码处理字节而非任意文本保存独立卡片。

原书依据 · 1 处

Worker

Worker对象是外部工作句柄,通过消息与错误事件观察独立执行环境。

外部工作句柄与内部全局分开关联本项背景,实质主要讲解在对应位置。

线程隔离仍需处理并发关联本项背景,实质主要讲解在对应位置。

全局错误返回值有特殊约定关联本项背景,实质主要讲解在对应位置。

线程自闭需要应用协议收尾关联本项背景,实质主要讲解在对应位置。

消息通道由对称端口组成关联本项背景,实质主要讲解在对应位置。

原书依据 · 14 处

WorkerGlobalScope

工作线程全局提供有限平台服务,专用线程的消息/关闭入口与共用WorkerGlobalScope职责分开。

工作线程全局不是页面全局关联本项背景,实质主要讲解在对应位置。

同步导入只适用于相应脚本模型关联本项背景,实质主要讲解在对应位置。

线程自闭需要应用协议收尾关联本项背景,实质主要讲解在对应位置。

全局错误返回值有特殊约定关联本项背景,实质主要讲解在对应位置。

原书依据 · 11 处

WorkerLocation

线程Location描述脚本环境地址,不提供页面导航控制。

地址分量保留各自边界关联本项背景,实质主要讲解在对应位置。

原书依据 · 4 处

线程地址可读而不能导航

WorkerLocation给主脚本环境URL的只读分量,没有Location.assign/reload导航能力。当前href声明含stringifier,可转为URL字符串;书中不能自动字符串化的表述不能当现行保证。地址是脚本来源定位,并不穷尽线程取得输入的渠道。

线程地址可读而不能导航保存独立卡片。

原书依据 · 1 处

WorkerNavigator

线程Navigator提供部分浏览器描述与联网估计,不意味着页面Navigator全部能力均可用。

浏览器嗅探只宜限定缺陷关联本项背景,实质主要讲解在对应位置。

联网标志不能证明服务可达关联本项背景,实质主要讲解在对应位置。

原书依据 · 7 处

XMLHttpRequest

XHR以受状态约束的请求配置和异步事件获取响应,响应格式与完成层次必须分别解释。

浏览器HTTP接口不是裸连接关联本项背景,实质主要讲解在对应位置。

请求配置遵循接口状态顺序关联本项背景,实质主要讲解在对应位置。

请求对象复用会影响在途操作关联本项背景,实质主要讲解在对应位置。

请求完成状态不代表成功关联本项背景,实质主要讲解在对应位置。

响应类型解析要处理空值和参数关联本项背景,实质主要讲解在对应位置。

响应解码不是任意字节转字符关联本项背景,实质主要讲解在对应位置。

HTTP头受浏览器接口约束关联本项背景,实质主要讲解在对应位置。

二进制响应使用对应结果入口关联本项背景,实质主要讲解在对应位置。

进度百分比需要可计算总量关联本项背景,实质主要讲解在对应位置。

超时定时器也有生命周期关联本项背景,实质主要讲解在对应位置。

原书依据 · 24 处

XMLHttpRequestUpload

upload是独立事件目标,用于观察请求主体传送而不是服务器处理完成。

进度百分比需要可计算总量关联本项背景,实质主要讲解在对应位置。

生命周期完成不等于操作成功关联本项背景,实质主要讲解在对应位置。

原书依据 · 8 处

封面介绍

封面介绍解释爪哇犀牛形象、泥水栖息习性、偷猎背景及封面版画来源,是书籍装帧附记。

跨章综合

全书贯穿的第一条联系是“值、身份与共享”。对象变量持有引用,原型提供共享属性查找,闭包保留词法环境;到了DOM,插入已有节点会移动原对象,而不是复制一段HTML文本。jQuery包装对象又增加一层集合身份:选区栈回退只切回集合,无法撤销已经做过的节点修改。二进制视图、对象URL和消息传送同样要求分清复制、共享与转移,不能只因变量名改变就假定底层数据已独立。

第二条联系是“调用、状态与完成”。语言函数的返回告诉调用者这次调用怎样结束,异步平台还通过状态和事件报告后续过程。XHR的DONE、上传100%、文件读取loadend、WebSocket关闭和IndexedDB单个请求成功都各有范围,不能自动提升为应用业务完成。真正的业务确认必须由相应协议或事务提交承担;取消和异常还要保留清理及结果归属,避免旧回调覆盖新状态。

第三条联系是“表示与解释”。字符串、URL编码、JSON、表单编码、字节与字符、CSS尺寸和画布坐标各有约定。相同文本只有放进明确的解析环境才有意义,文本插入与HTML执行不同,几何数值还需要坐标系、单位和变换前提。数据能被解析、页面能显示、图片能加载,也不证明内容可信或具有访问权限。

最后是“抽象仍有边界”。库可减少重复代码,不能消除浏览器权限、原生对象生命周期或版本差异。本书的历史材料有助于理解这些设计的来路;使用时应把核心机制、旧实现技巧与当前规范分别核对。这里的跨章归纳来自已经读完的本分册,当前规范差异是读者补充,未把任何代码推演写成运行成功。

发散与实践

读者延伸选择两项有限实践:“深读选区栈与节点移动”(ideas/idea-001-深读选区栈与节点移动.md)利用已保存的jQuery1.4.2源码说明对象身份与文档修改;“整理旧接口兼容核查表”(ideas/idea-002-整理旧接口兼容核查表.md)把当前已核验的接口差异应用到将来指定的旧页面。

已准备源码初步映射和五项兼容核查初表,详细阅读与真实页面观察仍待执行。没有运行浏览器/JavaScript/Node/Java示例,没有改变应用或部署旧库。这些是读者学习计划,不冒充作者主张或实验结论。未采用完整框架重写、全浏览器兼容矩阵与无对象的后台系统开发,因为它们没有增加当前问题所需的最小证据。

生成进度与管理记录

JavaScript权威指南(原书第6版)

类别:编程语言类

四象限结论:经典(高浓度 + 高稳定性)

阶段一:整体评级

结论:经典原理(第一部分语言核心) + 速查手册(第二至四部分)—— 全书以第一部分为核心价值,整体归类为「经典原理」,但需明确第二部分及参考手册部分的低留存价值

理由:

本书分四部分:第一部分「JavaScript语言核心」(第1~12章)、第二部分「客户端JavaScript」(第13~22章)、第三部分和第四部分分别是语言核心与客户端API的字母顺序参考手册。

  • 第一部分:讲的是类型系统、作用域链、原型继承、闭包、this绑定、函数式编程等语言底层设计决策——例如第8章解释函数声明提前与函数表达式赋值不提前的区别、闭包如何通过作用域链访问外部变量;第9章讲原型式继承如何模拟Java式类继承及其代价。这些是”为什么JavaScript这样设计”的内容,不随ES6+语法糖式更新而过时,属于高浓度+高稳定性。
  • 第二部分:讲的是2011年前后浏览器平台的具体API(Window对象、DOM脚本化、CSS脚本化、XHR、jQuery、HTML5 API等)。这类内容多为方法罗列式的操作指南,且第18章的XHR已被fetch取代、第19章整章讲jQuery(现代前端已普遍弃用)、第21/22章的Canvas/HTML5 API细节也已多次迭代——低浓度+低稳定性,速查手册特征明显。
  • 第三、四部分:明确写着”该文档根据类或对象的名字,按照字母来排序”,是纯API字典,无叙事内容,略读价值为零。

综合来看,本书的经典地位主要由第一部分支撑,第二部分及参考手册部分应作为时效性速查内容对待,不做卡片提炼。

类别清单核对(编程语言类)

维度 覆盖状态(已覆盖/补充生成/未覆盖) 关联卡片标题或未覆盖理由
类型系统与值语义 已覆盖 《原始值不可变与对象引用可变》《null与undefined的语义分工》覆盖值、引用和空缺语义。
内存管理与资源生命周期 未覆盖 既有卡片未覆盖垃圾回收、资源释放或内存生命周期模型。
并发/并行模型 未覆盖 既有卡片未形成事件循环、异步调度或并发语义的知识卡。
错误处理机制 未覆盖 既有卡片未覆盖异常传播、错误对象或错误恢复策略。
编译/执行模型 未覆盖 既有卡片未直接说明 JavaScript 的编译、解释/JIT 或执行模型。
模块/包与命名空间设计 已覆盖 《IIFE是块级作用域缺失时代的隔离手段》覆盖旧时代的模块隔离与命名空间边界。
语言设计哲学与取舍 已覆盖 《JS语言血统的三重混合》《鸭式辩型关注能做什么而非是什么》覆盖原型与结构化能力的取舍。
元编程/反射/宏能力 已覆盖 《存取器属性把属性访问伪装成方法调用》《借用Object原型的toString判断真实类型》覆盖动态对象与反射式技巧。
性能特性与其代价 已覆盖 《生成器实现惰性求值的处理管道》覆盖按需计算在内存和执行成本上的权衡。

阶段二 + 三:章节进度追踪表

章节号 章节标题 精读/略读 状态 卡片数
1 第1章 JavaScript概述 精读 done 1
- 第一部分 JavaScript语言核心(部分导言) 略读 done 0
2 第2章 词法结构 略读 done 0
3 第3章 类型、值和变量 精读 done 6
4 第4章 表达式和运算符 略读 done 0
5 第5章 语句 略读 done 0
6 第6章 对象 精读 done 4
7 第7章 数组 略读 done 0
8 第8章 函数 精读 done 5
9 第9章 类和模块 精读 done 5
10 第10章 正则表达式的模式匹配 略读 done 0
11 第11章 JavaScript的子集和扩展 精读 done 2
12 第12章 服务器端JavaScript 略读 done 0
- 第二部分 客户端JavaScript(部分导言) 略读 done 0
13 第13章 Web浏览器中的JavaScript 略读 done 0
14 第14章 Window对象 略读 done 0
15 第15章 脚本化文档 略读 done 0
16 第16章 脚本化CSS 略读 done 0
17 第17章 事件处理 精读 done 2
18 第18章 脚本化HTTP 略读 done 0
19 第19章 jQuery类库 略读 done 0
20 第20章 客户端存储 略读 done 0
21 第21章 多媒体和图形编程 略读 done 0
22 第22章 HTML5 API 略读 done 0
- 第三部分 JavaScript核心参考 略读 done 0
- 第四部分 客户端JavaScript参考 略读 done 0
章节 spine 文件映射(用于阶段三读取)
  • 第1章 → text/part0009_split_000.html, part0009_split_001.html
  • 第3章 → text/part0012.html
  • 第6章 → text/part0015.html
  • 第8章 → text/part0017.html
  • 第9章 → text/part0018.html
  • 第11章 → text/part0020.html
  • 第17章 → text/part0026.html

2026-10-27 本批恢复

执行模式:light

本次实际执行版本:book-workflow v4 / book-notes v23;保留历史首次生成版本及25张原卡身份。

继承经典原理为主的评级:核心语言解释具有迁移价值,浏览器及API部分带2011年前后的版本边界。历史“低价值所以略读完成”和“全部API不取材”不作为本轮放行依据;全部实质正文及参考部分已纳入待办,具体取舍在完整阅读后确定。主形态按实际占比于全文收束确认,局部参考条目按操作参考规则。

建档进度:done

实践候选筛选:done

当前章节进度
章节号 章节标题 状态 卡片数
spine-9 译者序 done 0
spine-10 前言 done 0
spine-16 第1章 JavaScript概述 done 4
spine-17 1.1 JavaScript语言核心 done 9
spine-18 1.2 客户端JavaScript done 17
spine-19 第一部分 JavaScript语言核心 done 0
spine-20 第2章 词法结构 done 15
spine-21 第3章 类型、值和变量 done 54
spine-22 第4章 表达式和运算符 done 44
spine-23 第5章 语句 done 40
spine-24 第6章 对象 done 33
spine-25 第7章 数组 done 27
spine-26 第8章 函数 done 35
spine-27 第9章 类和模块 done 52
spine-28 第10章 正则表达式的模式匹配 done 18
spine-29 第11章 JavaScript的子集和扩展 done 31
spine-30 第12章 服务器端JavaScript done 35
spine-31 第二部分 客户端JavaScript done 0
spine-32 第13章 Web浏览器中的JavaScript done 37
spine-33 第14章 Window对象 done 22
spine-34 第15章 脚本化文档 done 68
spine-35 第16章 脚本化CSS done 36
spine-36 第17章 事件处理 done 36
spine-37 第18章 脚本化HTTP done 29
spine-38 第19章 jQuery类库 done 76
spine-39 第20章 客户端存储 done 33
spine-40 第21章 多媒体和图形编程 done 63
spine-41 第22章 HTML5 API done 60
spine-42 第三部分 JavaScript核心参考 done 0
spine-43 JavaScript核心参考 done 13
spine-44 isNaN() done 15
spine-45 第四部分 客户端JavaScript参考 done 0
spine-46 客户端JavaScript参考 done 9
spine-47 HTMLElement done 29
spine-49 封面介绍 done 0
当前非正文排除候选
spine项 类型 排除理由
4 封面 已实际查看第6版封面,确认作者与译者,无额外正文
5 书名与版权页 已完整读取出版身份与ISBN,无独立语言知识
6 纯目录 完整目录仅提供导航,35个正文spine已读。
7 出版商推广 已完整读取出版商历史与推广内容,无本书机制解释
8 出版商评价 已完整读取出版商品牌评价,无本书机制解释
11 版权倡议 版权倡议和购买呼吁,无技术机制。
12 排版约定 排版约定已读,用于识别代码和占位符,无独立知识。
13 示例使用许可 示例使用许可和下载入口已读,无技术机制。
14 联系方式与勘误入口 勘误和出版联系方式已读,纯服务入口。
15 致谢 编辑、审校、绘图、索引及亲友致谢全文已读,无展开方法。
48 作者简介 作者履历和著作简介已读,无技术机制。
50 译者简介 七位译者履历和翻译分工全文已读,项目仅履历提名。
当前待关联术语
术语名 出现章节 一句话语境
registerProtocolHandler 客户端参考 浏览器协议处理注册,实际许可和兼容性另核验。
Perl5正则语法 10 作为JavaScript正则历史相似性的比较,具体差异未展开
Haskell 8.8 作为函数式风格语言的比较提名,未展开具体机制
Lisp 8.8 作为函数式风格语言的比较提名,未展开具体机制
monkey-patching 8.7.3 运行时替换已有方法以包装其调用,本例用于日志
跳转表 5 脚注解释其他语言常量case可能编译为该形式,未展开具体实现
execScript 4 旧IE全局脚本执行入口,只作历史差异提名
with 3 作用域链用途提名,正文第5章再展开
Perl 3 正则语法来源提名,未展开这门语言
Token 2 词法单元,脚注仅给出百科入口,本章通过规则说明作用
HTTP 1 后文网络请求能力的预告,本处未展开协议
HTML5 1 后文Web平台API预告,本处未展开标准
Canvas 1 后文图形接口预告,本处未展开绘图机制
Self 1 语言谱系中的原型来源,仅提名
Scheme 1 语言谱系中的一等函数来源,仅提名
CSS 1 描述样式,此处未展开机制
HTML 1 描述网页内容,此处未展开语法
当前引用文献
标题 类型 出现章节 一句话语境
json2.js 源码项目 spine-43 JSON 旧环境JSON兼容实现引用,源码未读
node-websocket-server 源码项目 spine-41 22.9 原书Node聊天服务器所用第三方旧库,源码未读、兼容性未验证
Beautiful Evidence 书 21 Edward Tufte关于迷你图的进一步阅读建议,本轮未读取该书。
CNode中文文档 文档项目 12.2脚注[4] 当时中文翻译资源推荐,未核验当前更新状态
CommonJS Modules 1.0 模块规范 12.2.2脚注[7] 原书Node模块约定出处,本轮未通读规范
Secure Mashups with dojox.secure 公开文章 11.1.2脚注[5] Dojo安全扩展的详细介绍链接,仅登记未阅读全文
ECMA-357 ECMAScript for XML 标准文档 11.7脚注[11] E4X语法与语义来源;当前官方分类Withdrawn,未声称通读规范
Typesafe Enums(Joshua Bloch) 公开文章 9.6.2脚注[6] 扑克牌枚举例子的Java出处,未独立阅读或核验实现
Effective Java 图书 9.7.3脚注[9] 组合与继承取舍的延伸阅读推荐,未声称已读
Design Patterns 图书 9.7.3脚注[9] 组合优于继承相关延伸阅读,本节未展开原书内容
Functional JavaScript Library(Oliver Steele) 源码项目 8.8脚注[18] 作者推荐阅读的函数式JavaScript库,原书未展开项目实现
Method Chaining 公开文章 8.2.2脚注[3] 链式调用术语的延伸阅读,未核验最早提出者
Prototypal Inheritance 公开文章 6.1.4脚注[2] 作为简化继承函数的历史出处,未作当前API兼容承诺
JavaScript Engine(李晶讲义) 论文 3 脚注12提供进一步理解引擎与提升的PPT,未阅读外部讲义
Unicode Character Database(UAX #44) 论文 2 脚注提供Unicode类别属性的进一步说明,未完整读该外部报告
当前资金安全问题案例
问题标题 问题卡 解决方案卡(如有) 出现章节 一句话说明
小数金额差值出现比较偏差 [[小数金额差值出现比较偏差]] [[整数最小单位保存金额]] 3 原书美分减法教学示例,二进制近似导致比较偏差;整数单位需范围与舍入契约

整书笔记是本轮阅读正文与来源定位真源,本分册生成、导入对账与归档已齐备。

本次实践卡进度
序号 实践标题 实践方式 状态(pending/done) 关联章节 产出
1 深读选区栈与节点移动 实现深读 done 19、客户端参考 ideas/idea-001-深读选区栈与节点移动.md;ideas/practice-001-source-map.md
2 整理旧接口兼容核查表 真实任务 done 18、22、客户端参考 ideas/idea-002-整理旧接口兼容核查表.md;ideas/practice-002-compatibility-map.md

筛选已结束:优先第一项理解对象身份,再用第二项整理接口边界;没有为每种API单独造实践。完整框架实现、无真实应用的兼容迁移和全浏览器实验暂不采用。两张计划交付完成,现实执行未开展。

生成结果:35个正文spine、836/836单元、130/130图片、12项排除均齐备;940张知识卡各有唯一primary与至少一处原书出处,共1648出处。轻量模式:未执行笔记复核、独立审查及审查结果优化。前面的旧版精读/略读与25卡统计仅保留历史,不作为本次完成依据。

本次导入与归档结果

940/940张知识卡已导入且filed、编号非空,原25张卡的ID、路径及编号保留。1648处引用与1648处原文来源通过数据库对账。旧关系保留21条、更正4条、删除无强关联1条;具体金额问题与方案互链已解析。pending为0;1条Prototype为ECMAScript内部槽原文误识别,已记skipped,原因与后续在工作流及本批wikilink-decisions.json。2张实践计划已交付,实践未执行。light未执行笔记复核、独立审查及审查结果优化。

2026-11-14 V24完整工作流恢复

本次执行版本:book-workflow v4 / book-notes v24,显式模式light;保留首次及v23生成记录。范围为P3合集174第01分册,独立总表263;沿用已有拆书与唯一笔记身份,不把整套21册标为完成。

原书9991资源与缓存逐字节匹配,947份历史交付文件hash一致。原始OPF重建4307项spine,实际4..50共47项与拆书映射相符(35正文+12排除);旧source.json的spine子集字段过期,当前不沿用,正确范围及来源清单见本轮source.json。836单元/885片段/130图像完整阅读证据有效,全文文本重派生及原始HTML区间覆盖核验通过。

复用940知识卡、2实践计划(实现深读/真实任务各1)及2份已填写首轮材料,新卡0、修订知识卡0,无删除/合并/重命名。jQuery1.4.2固定源码hash再次匹配,历史规范核验日期2026-10-27保留,不宣称本轮重新联网或推荐部署旧库。

整书笔记为唯一阅读正文;轻量模式未执行笔记复核、独立审查及审查结果优化,实际实践未执行。内部槽记号[[Prototype]]被扫描为链接的历史记录10268已有skipped原因,保留扫描器P2后续。证据.local/runs/js17401-20261114/,导入、940卡归档及1648定位/出处验收见_workflow.md。

相关主题

从本书的主题进入跨书阅读,对照其他书籍的讲解。下方数量包含主题关联的全部卡片与书籍。

暂无公开主题。