已废弃的Headers.getAll() API重实现：如何可靠解析多值HTTP头？

应用背景 #

此前Headers.getAll()是一套被广泛验证的多值HTTP头解析方案，目前该方法已被废弃、从Web标准规范中移除。现在的Headers接口没有原生的多值头解析能力，调用原生Headers.get()时，只会把同一个头的所有取值拼成长字符串返回，没法直接拿到拆分好的多值数组。

核心重实现逻辑 #

重写逻辑需要严格对齐HTTP协议对多值头的定义，同时规避不同浏览器在Headers接口实现上的特殊坑点，整体实现遵循三个核心原则：

• 先做头名的大小写归一匹配，契合HTTP头名大小写不敏感的规则，避免匹配失效
• 针对有特殊实现的响应头（比如Set-Cookie），绕过原生Headers.get()的单值限制，通过遍历Headers条目收集所有同名下的取值
• 对拼接后的原始字符串做符合协议规则的拆分，避免把引号包裹内容里的逗号误判为多值分隔符

可直接复用的实现代码 #

/**
 * 重实现废弃的Headers.getAll()方法，可靠解析多值HTTP头
 * @param {Headers} headersInstance 目标Headers实例
 * @param {string} headerName 要获取的HTTP头名称
 * @returns {string[]} 拆分后的多值数组，不存在对应头时返回空数组
 */
function getAllHeaderValues(headersInstance, headerName) {
  const normalizedName = headerName.toLowerCase();
  const valueList = [];

  // 特殊场景处理：Set-Cookie 不受通用字符串拼接规则约束，需要遍历收集
  if (normalizedName === 'set-cookie') {
    headersInstance.forEach((value, key) => {
      if (key.toLowerCase() === normalizedName) {
        valueList.push(value.trim());
      }
    });
    return valueList;
  }

  // 通用场景获取原始拼接值
  const rawCombinedValue = headersInstance.get(normalizedName);
  if (!rawCombinedValue) return valueList;

  // 按HTTP规范拆分，跳过双引号包裹内容内的逗号
  let currentChunk = '';
  let isInsideQuotes = false;
  for (const char of rawCombinedValue) {
    if (char === '"') {
      isInsideQuotes = !isInsideQuotes;
      currentChunk += char;
      continue;
    }
    if (char === ',' && !isInsideQuotes) {
      valueList.push(currentChunk.trim());
      currentChunk = '';
      continue;
    }
    currentChunk += char;
  }

  // 收尾处理最后一段内容
  if (currentChunk.trim()) {
    valueList.push(currentChunk.trim());
  }
  return valueList;
}

实现避坑说明 #

• 绝对不要直接对Headers.get()的返回值做裸split(',')，这种方式会把头值里被双引号包裹的逗号误判为多值分隔符，比如带文件名参数的Content-Disposition、带定位参数的Link头都会出现解析错误
• 必须单独处理Set-Cookie的特殊规则：当前Fetch规范对Set-Cookie有特殊实现，多个Set-Cookie不会被拼接成单个字符串，普通的Headers.get()只会返回第一个Cookie值，必须通过遍历Headers的所有条目才能拿到全量的Set-Cookie列表
• 拆分完成后要对每个值做首尾空白裁剪，契合HTTP多值头的通用格式——协议里多值之间的逗号后面通常会附带一个空格，不裁剪会导致每个值都带有无意义的前置空格

内容的提问来源于stack exchange，提问作者cyberixae