structuredClone() 无法拷贝 AudioParam 对象，因其是绑定音频上下文的不可序列化运行时接口，调用会抛出 DATA_CLONE_ERR 错误；应手动提取 value、defaultValue 等可序列化字段构建纯数据副本后再克隆。
structuredClone() 无法拷贝 AudioParam 对象，这是关键前提。AudioParam 是 Web Audio API 中的内置接口对象，属于不可序列化的类型（non-serializable），在 structuredClone 的规范限制范围内。调用 structuredClone() 处理含 AudioParam 的对象时，会直接抛出 DATA_CLONE_ERR 类型错误，而不是静默失败或忽略该属性。
为什么 AudioParam 不支持 structuredClone()
structuredClone() 仅支持可结构化克隆（structured clone）的类型，例如普通对象、数组、Map、Set、Date、RegExp、ArrayBuffer 及其视图、ImageBitmap、Error（部分）、FormData 等。AudioParam 是一个绑定到音频渲染上下文（AudioContext）的实时控制接口，内部包含状态、调度队列、时间线引用等无法脱离上下文复制的运行时资源。它既不是纯数据，也不符合结构化克隆的“可传输性”要求。
替代方案：手动提取可序列化参数值
若目标是保存/传输 AudioParam 的当前配置（如 value、defaultValue、minValue、maxValue、automationState），应显式提取其可序列化字段，而非尝试克隆整个 AudioParam 实例：
- 用
param.value获取当前数值（注意：value 是只读属性，反映当前计算值；设置需用setValueAtTime()等方法） - 读取
param.defaultValue、param.minValue、param.maxValue（均为 number） - 检查
param.automationRate（"a-rate" 或 "k-rate"，字符串） - 若需还原自动化曲线，需单独记录
getStates()（Chrome 117+）或通过getFloat32Array()+ 时间戳重建（兼容性有限）
实用示例：安全克隆含 AudioParam 的配置对象
假设你有如下对象：
const nodeConfig = {
type: 'gain',
gain: audioContext.createGain().gain, // AudioParam 实例
pan: audioContext.createStereoPanner().pan // AudioParam 实例
};
正确做法是构建一个纯数据副本：
function serializeAudioParam(param) {
return {
value: param.value,
defaultValue: param.defaultValue,
minValue: param.minValue,
maxValue: param.maxValue,
automationRate: param.automationRate
};
}
const safeCopy = {
...nodeConfig,
gain: serializeAudioParam(nodeConfig.gain),
pan: serializeAudioParam(nodeConfig.pan)
};
// 此时 safeCopy 可被 structuredClone 安全处理
const cloned = structuredClone(safeCopy);
还原时需重新绑定到 AudioContext
克隆后的参数数据只是快照，不能直接赋给新节点。要恢复行为，必须在目标 AudioContext 中创建新节点，并用保存的值初始化：
- 创建对应 AudioNode（如 GainNode、StereoPannerNode）
- 用
setValueAtTime(safeCopy.gain.value, audioContext.currentTime)设置初始值 - 如有自动化事件，需调用
setTargetAtTime()、linearRampToValueAtTime()等按序重放 - 注意：不同 AudioContext 的时间线不互通，需校准 currentTime 偏移
