首页
/ Web Platform Tests项目中的Local Network Access(LNA)命名规范更新

Web Platform Tests项目中的Local Network Access(LNA)命名规范更新

2025-06-11 21:49:46作者:廉皓灿Ida

Web Platform Tests(WPT)是一个由W3C维护的开源项目,旨在为Web平台提供跨浏览器的测试套件,确保不同浏览器对Web标准的实现保持一致性和互操作性。该项目包含了数以万计的测试用例,覆盖了HTML、CSS、JavaScript等Web技术的各个方面。

LNA与PNA命名规范的演变

在最新的提交中,Web Platform Tests项目对Local Network Access(LNA)相关的fetch API中的targetAddressSpace参数命名进行了重要更新。这一变更反映了从Private Network Access(PNA)到Local Network Access(LNA)命名规范的过渡。

新旧命名对照表

旧名称(PNA) 新名称(LNA)
local loopback
private local
public public

值得注意的是,虽然主要命名已经更新,但为了向后兼容,"private"仍将作为"local"的别名保留。

技术背景与变更意义

这一命名规范的更新不仅仅是简单的词汇替换,它反映了Web安全模型中对网络访问权限控制的更精确描述。新的命名体系更加清晰地划分了不同层级的网络访问权限:

  1. loopback:指代本地回环地址(如127.0.0.1),用于同一设备内的通信
  2. local:指代本地网络范围内的访问(如192.168.x.x等私有地址空间)
  3. public:指代公共互联网上的资源访问

这种更精确的命名有助于开发者更清楚地理解和使用这些API,同时也使规范文档和测试用例更加易于理解。

相关测试用例的调整

作为这次变更的一部分,项目移除了private-network-access/mixed-content-fetch.tentative.https.window.js测试文件。这是因为PNA相关实现正在被逐步淘汰,而保持这个测试在新的命名体系下工作会带来不必要的复杂性。

对开发者的影响

对于使用fetch API并涉及网络访问控制的开发者来说,这一变更意味着:

  1. 建议尽快将代码中的旧参数名更新为新名称
  2. 虽然"private"仍可作为"local"的别名使用,但新代码应采用"local"这一规范名称
  3. 需要关注浏览器对这一变更的实现进度,确保兼容性

这一变更体现了Web平台持续演进的特点,也展示了Web Platform Tests项目在推动Web标准一致实现方面的重要作用。通过这样的规范更新和测试调整,确保了不同浏览器在处理网络访问权限时能够提供一致的行为和开发者体验。

登录后查看全文
热门项目推荐