compareDocumentPosition返回值描述otherNode相对于node的位置，即nodeB相对于nodeA的关系；返回值是位掩码，需用位与判断而非全等，如pos & Node.DOCUMENT_POSITION_FOLLOWING表示nodeB在nodeA之后。
compareDocumentPosition返回值是otherNode相对于node的位置
调用nodeA.compareDocumentPosition(nodeB)时，返回值描述的是nodeB相对于nodeA的位置，不是反过来。这点容易记反——比如返回4，意思是nodeB在nodeA之后（即nodeA在nodeB之前），对应常量Node.DOCUMENT_POSITION_FOLLOWING。
常见误判：把pos === 4当作“nodeA在nodeB之后”，实际恰恰相反。必须结合语义读：返回值是“nodeB相对于nodeA”的关系。
-
pos & Node.DOCUMENT_POSITION_PRECEDING→nodeB在nodeA前 -
pos & Node.DOCUMENT_POSITION_FOLLOWING→nodeB在nodeA后 -
pos & Node.DOCUMENT_POSITION_CONTAINS→nodeB包含nodeA -
pos & Node.DOCUMENT_POSITION_CONTAINED_BY→nodeB被nodeA包含
为什么不能直接用===判断返回值
compareDocumentPosition()返回的是位掩码（bitmask），不是单一状态枚举。比如20 = 16 | 4，表示nodeB被nodeA包含（16）且nodeB在nodeA之后（4）。若写if (pos === 4)，会漏掉所有含4但还有其他位的组合值（如20、36、44）。
实操必须用位与：if (pos & Node.DOCUMENT_POSITION_FOLLOWING)才真正表达“nodeB在nodeA之后”。
立即学习“前端免费学习笔记（深入）”；
- 返回
0：两节点是同一个节点（nodeA === nodeB） - 返回
1：nodeA.ownerDocument !== nodeB.ownerDocument，跨文档或脱离文档 - 返回
32：通常出现在比较同一元素的两个属性节点，实际业务中极少遇到
contenteditable编辑器中判断光标前后顺序的陷阱
富文本编辑场景下，直接用compareDocumentPosition判断插入点或选区边界顺序，极易出错。因为父子/包含关系会干扰“线性文档流先后”的真实意图。
比如div > p > span，span和p比较返回20（16 | 4），你只关心“谁该排在光标前面”，但span其实在p内部——它根本不在同一层级上。
- 务必先校验同文档：
if (nodeA.ownerDocument !== nodeB.ownerDocument) return null - 只取纯粹前后关系：
pos & Node.DOCUMENT_POSITION_FOLLOWING或pos & Node.DOCUMENT_POSITION_PRECEDING - 如需排除嵌套影响（例如只比兄弟节点），加过滤：
!(pos & (Node.DOCUMENT_POSITION_CONTAINS | Node.DOCUMENT_POSITION_CONTAINED_BY)) - 文本节点位置不等于父元素位置；要算字符偏移，得结合
textContent长度和node.textContent.length
IE8兼容性与替代方案
compareDocumentPosition在IE9+才原生支持。IE8及更早版本需降级处理，典型做法是用sourceIndex（仅限Element节点，不适用于Text、Comment等）：
function comparePositionIE8(a, b) {
if (a.sourceIndex !== undefined && b.sourceIndex !== undefined) {
return a.sourceIndex - b.sourceIndex;
}
return 0;
}但sourceIndex有严重局限：不保证全局唯一性，多个DOM树（如iframe）、动态插入节点都可能导致索引重复或错乱；且无法表达包含关系。现代项目若还需支持IE8，建议封装层统一拦截并抛出明确错误，而非静默 fallback。
真正容易被忽略的是：Shadow DOM边界调用compareDocumentPosition会返回1（DOCUMENT_POSITION_DISCONNECTED），但很多编辑器逻辑没做这个检查，后续直接按“可比”处理，导致光标跳转异常或插入点错乱。
