豫言 / 豫言操作系统网址定位适配 @ 0.2.0

以云工 URL 实现绝对与相对网址解析,返回完整部件。

源码浏览已生成;不能解析的文件以纯文本展示,不表示通过类型检查。

说明.汉语.md

# 云工网址定位适配

使用当前云工宿主的 URL 对象解析绝对及相对地址,向应用交付 `href`、`origin`、`pathname`、`search`、`protocol`、`hostname`、`host`、`port`、`username`、`password`、`hash` 十一项 JSON 文字,字段值全部取自宿主 URL 对象。输入文字先交给宿主自己的 `TextDecoder` 序列化成 JSON 字面量再拼进 `URL.parse` 的参数,因此控制字符与任意 UTF-8 都不会破坏参数;无法解析时 `URL.parse` 返回 null,适配把它转成可捕获的豫言异常,不让宿主异常越过 Wasm 边界。适配不发起网络请求,也不替应用决定哪些来源或路径可以访问。

不需要新的宿主原语;需要平台支持 `URL.parse`(云工的兼容日期已满足)。

说明.文言.md

# 云工网址定位适配

借云工宿主之 URL 物析绝对与相对址,以 JSON 文授 `href`、`origin`、`pathname`、`search`、`protocol`、`hostname`、`host`、`port`、`username`、`password`、`hash` 十一项,诸字段皆取自宿主之 URL 物。所入之文先交宿主自身之 `TextDecoder` 书为 JSON 字面,而后并入 `URL.parse` 之参,故控字符及任意 UTF-8 不伤参;不可析则 `URL.parse` 返空,适配转之为可捕之事故,不令宿主之异越过 Wasm 之界。适配不发网,不代客定可访之源与径。

无须新宿主原语;平台须支持 `URL.parse`(云工之兼容日期已足)。