insertAdjacentElement的插入位置参数只能是四个固定小写字符串：'beforebegin'、'afterbegin'、'beforeend'、'afterend'；传入大驼峰、拼错、空值或非Element类型均会报错或静默失败；宿主元素必须已挂载DOM（可用isConnected检查），且不支持DocumentFragment。
insertAdjacentElement 的插入位置参数必须是字符串
这个方法不会接受数字或变量名作为位置，只认四个固定字符串：'beforebegin'、'afterbegin'、'beforeend'、'afterend'。写成 'beforeBegin' 或 'BeforeEnd' 都会静默失败——元素不插入，也不报错。
常见误用场景：
- 从其他语言习惯写成大驼峰（如
'AfterEnd'） - 拼错单词（如
'beferend'） - 传入变量但变量值为空或未定义，导致调用等价于
el.insertAdjacentElement('', elem)
目标元素必须已挂载到 DOM 才能使用 insertAdjacentElement
如果 insertAdjacentElement 调用时，宿主元素（即调用该方法的那个元素）还没添加进文档（比如刚用 document.createElement 创建完），浏览器会抛出 NotFoundError 错误：
DOMException: Failed to execute 'insertAdjacentElement' on 'Element': The node before which the new node is to be inserted is not a child of this node.
解决办法很简单：
立即学习“前端免费学习笔记（深入）”；
- 确保宿主元素已存在且在 DOM 中（可用
el.isConnected检查） - 或者先用
appendChild或insertBefore把宿主元素挂上，再调用insertAdjacentElement - 不要试图对
DocumentFragment调用该方法——它不支持
第二个参数必须是 Element 类型，不能是 HTML 字符串或文本节点
insertAdjacentElement 名字里带 “Element”，就只吃 Element 实例。传 document.createTextNode('x') 或 '<div>hello</div>' 会直接报错：
TypeError: Failed to execute 'insertAdjacentElement' on 'Element': parameter 2 is not of type 'Element'.
如果你手头是字符串，得先转成元素：
- 用
document.createElement+ 属性/文本手动构建 - 更常用的是
document.createElement('template').content方式解析 HTML 字符串：const temp = document.createElement('template'); temp.innerHTML = '<span>ok</span>'; const el = temp.content.firstElementChild; - 注意：不要用
innerHTML直接赋给普通元素再取子节点——容易意外执行脚本或污染结构
和 insertAdjacentHTML / insertAdjacentText 的关键区别在哪
三者 API 形式一致，但类型约束完全不同：
-
insertAdjacentElement：只接受Element，不解析 HTML，无 XSS 风险，性能略高 -
insertAdjacentHTML：接受字符串，自动解析并插入，但需自行防范注入；支持'beforebegin'等全部四种位置 -
insertAdjacentText：只插入纯文本（转义后），生成的是Text节点，不是元素
选哪个，取决于你手上是什么、是否需要解析、是否信任内容来源。别为了图省事把字符串硬塞给 insertAdjacentElement——它真不干这活。
最常被忽略的一点：这些方法都不触发重排（reflow）的批量优化，频繁调用会比一次性操作 fragment 慢。如果要插多个元素，先建 DocumentFragment，再用 append 或 appendChild 批量上树，最后用一次 insertAdjacentElement 插入整个 fragment 更稳妥。
