读态
公开「元类型」文言:读态者,一答之读势也;表居实例之内,事毕随实例而弃,不越事而存。汉语:每个响应柄对应一条读取状态,表存放在本次事件的 Wasm 实例内,事件结束即随实例消失。字段依次为:响应柄、中断信号号、读取器号、解码器号、余块号、余块偏移、余块总长、结局(零读取中,一已读尽,二读取错误,三超时或已取消)、结局文、待出文字。
包说明.html模块 / 2
请求。豫
「元类型」文言:读态者,一答之读势也;表居实例之内,事毕随实例而弃,不越事而存。汉语:每个响应柄对应一条读取状态,表存放在本次事件的 Wasm 实例内,事件结束即随实例消失。字段依次为:响应柄、中断信号号、读取器号、解码器号、余块号、余块偏移、余块总长、结局(零读取中,一已读尽,二读取错误,三超时或已取消)、结局文、待出文字。
(「引用类」于(「列」于(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)))暂无说明。
化「字符串」而化「字符串」而(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)文言:造新读势,字段皆空。汉语:创建响应柄的初始读取状态:尚无读取器、解码器、余块,结局为读取中。
化(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)而化「字符串」而化「字符串」而(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)文言:易读器与解码器之柄。汉语:返回替换了读取器号与解码器号的新状态。
化(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)而化「字符串」而化「整数」而化「整数」而(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)文言:易余块之柄、偏移与总长。汉语:返回替换了余块号、余块偏移与余块总长的新状态。
化(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)而化「字符串」而(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)文言:易待出之文。汉语:返回替换了待出文字的新状态。
化「字符串」而「有」文言:柄非空则释之。汉语:句柄号非空时释放宿主句柄,空则什么也不做。
化(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)而化「整数」而化「字符串」而(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)文言:结局既定,则释读器、解码器、余块与信号诸柄,以免久占句柄表。汉语:进入终态时释放全部临时宿主句柄,并把结局写入状态。
化(「列」于(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」))而化(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)而(「列」于(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」))文言:表中同柄者易之,无则增。汉语:在状态表里替换同一响应柄的状态,表中没有则追加。
化(「列」于(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」))而化「字符串」而(「爻」合(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」))文言:按柄查表,得(有无,态)。汉语:按响应柄查状态表,返回(是否找到,状态)。
化(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)而「有」文言:书态入表。汉语:把状态写回本次事件的状态表。
化「字符串」而化「字符串」而「有」文言:新答柄入表,并记其信号。汉语:为新签发的响应柄登记初始状态并记下中断信号号(无信号为空串)。
化「字符串」而(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)文言:取柄之态;非本包所发者告事故。汉语:取响应柄的状态;不是本事件内由本包签发的柄抛豫言异常。
化「字符串」而「爻」文言:此柄之答已启增量之读者,不可再整读或转为终答。汉语:判断响应柄是否已开始增量读取(读取器已创建或已有结局);旧的整体读取与原流转发函数据此拒绝,避免对已上锁的流抛出无法捕获的宿主错误。
化「字符串」而「字符串」文言:宿主抛错之名与文合为一句,供应用记录。汉语:把安全方法调用返回的错误 JSON(名称与消息)合成一句“名称: 消息”。
化「整数」而「爻」文言:验 UTF-8 续字节(二进制十开头)。汉语:判断一个字节是否是 UTF-8 的续字节(0x80 至 0xBF)。
化「字符串」而化「整数」而「整数」文言:自位向前求码点之首字节。汉语:从字节位置向前找到所在码点的首字节位置。
化「字符串」而化「整数」而化「整数」而化「整数」而「整数」文言:数止位之前码点首字节之数。汉语:统计字节区间内码点首字节(非续字节)的个数,即码点数。
化「字符串」而化「整数」而(「字符串」合「字符串」)文言:依字节之限裁文,必断于码点之界,不留半字。汉语:把文字切成不超过给定 UTF-8 字节数的前段和余段,切点落在码点边界,绝不产生被截断的半个字符。
化「字符串」而化「字符串」而(「爻」合「字符串」)文言:造读器;有信号则以管道系之。汉语:创建读取器:没有信号时直接取正文流的读取器;有信号时经恒等转换流的管道把信号接到正文流再取读取器。返回(成功,读取器号或错误文)。
化(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)而(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)文言:初读乃开读器;有信号则以管道系之,使期满则读败而源亦消;无正文者径终。汉语:首次读取时才创建读取器:有中断信号时经恒等转换流的管道把信号接到正文流,超时后读取会失败且上游被取消;没有正文的响应直接进入已读尽状态。
化(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)而化「整数」而((「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)合「整数」合「字节串」合「字符串」)文言:自余块取至多上限字节。汉语:从上次多出的余块中取至多上限个字节;取尽则释放余块。
化(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)而化「字符串」而化「整数」而化「整数」而((「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)合「整数」合「字节串」合「字符串」)文言:上游一块过大则留其余于状态。汉语:把上游一块按上限切开:块不大于上限则整取并释放;否则取前段,余部作为余块留在状态里。
化(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)而化「整数」而((「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)合「整数」合「字节串」合「字符串」)文言:取原字至多上限个;种类零得字,一流终,二读败。汉语:取下一段原始字节,至多上限个;上游一块过大则余部留在状态中。返回:新状态、种类(零得字节,一流已终,二读取失败)、字节、错误文。
化(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)而化「整数」而((「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)合「整数」合「字符串」合「整数」)文言:流终则冲解码器之余,定局为一。汉语:流结束时冲刷解码器(残缺序列成 U+FFFD),把状态定为已读尽。
化(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)而化「字符串」而化「整数」而((「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)合「整数」合「字符串」合「整数」)文言:读败则察信号:期满为三,否则为二。汉语:读取失败时检查中断信号:已中断则定为超时(三),否则定为读取错误(二)。
化(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)而化「整数」而化「整数」而化「整数」而((「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)合「整数」合「字符串」合「整数」)文言:读一段原字而续解之;不成字则再读,至得文、流终、败或时尽。返回:新状态、种类(零得文,一流终,二败,三超时或已消)、文或说明、本次所耗原字数。汉语:读取并流式解码:不足一个完整字符时继续读取,直到得到非空文字、流结束、失败或超时/取消。返回:新状态、种类、文字或说明、本次消耗的原始字节数。
化(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)而化「整数」而((「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)合「整数」合「字符串」)文言:出块者,先出待出之文,次读上游;文之长逾限则裁而留其余。汉语:按上限出一块文字:先把上次多出的待出文字切出来;没有待出文字时读取上游并解码;解码所得若超过上限,则切出前段并把余段留作待出文字。返回:新状态、种类、文字。
化(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)而化「字符串」而(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)文言:取消者,经读器(未创读器则径对正文流)对源流行 cancel;幂等,已定局者不再动。汉语:取消响应读取:通过读取器(或尚未创建读取器时直接对正文流)执行 cancel,上游能否观察到取决于平台;幂等,已有结局的状态不变。
化「字符串」而化「整数」而化「整数」而「爻」文言:验文自位至长皆十进制数字。汉语:判断字符串从位置到长度是否全是十进制数字字节。
化(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)而「整数」文言:观答之 Content-Length;无或坏则负一。汉语:读取响应的 Content-Length:缺失或不是数字返回 -1。
化(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)而化「整数」而化「整数」而化(「列」于「字符串」)而((「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)合「整数」合「字符串」)文言:累读至终,不逾上限;逾则取消而告过大。每次至多多读一字,故限内不多取。汉语:循环读取并累计原始字节:超过上限立即取消并返回状态一;流结束则拼接全部文字返回状态零;失败或超时返回二、三。
化(「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)而化「整数」而((「字符串」合「字符串」合「字符串」合「字符串」合「字符串」合「整数」合「整数」合「整数」合「字符串」合「字符串」)合「整数」合「字符串」)文言:整读余文而限其字节,结局定则径返。汉语:有限整读:已有错误或取消结局则直接返回;先看声明长度和待出文字,再循环累计。返回(新状态,状态,文字)。
化「整数」而「爻」文言:验字节是否合 HTTP 令牌。汉语:判断字节是否属于 HTTP 标头令牌字符集(字母、数字与 !#$%&'*+-.^_`|~)。
化「整数」而「爻」文言:验字节为可见 ASCII(空格至波浪号)。汉语:判断字节是否是可见 ASCII 字符(0x20 至 0x7E)。
化「字符串」而化「整数」而化「整数」而化化「整数」而「爻」而「爻」文言:验文自位至长之字节皆合谓词。汉语:判断字符串从位置到长度的每个字节是否都满足给定条件。
化「字符串」而「爻」文言:标头名须为一至一二八字节之令牌。汉语:标头名须是 1 至 128 字节的合法令牌。
化「字符串」而化「整数」而化「整数」而化「字符串」而「字符串」文言:逐字节转 ASCII 小写。汉语:逐字节把 ASCII 大写字母转成小写并累积。
化「字符串」而「字符串」文言:仅施于已验为令牌之名,故字节皆在可见之域。汉语:把已验证为标头令牌的名字转成 ASCII 小写;不能用于含非 ASCII 字节的文字。
化「字符串」而化(「列」于「字符串」)而「爻」文言:名已在列则阳。汉语:判断名字是否已在列表中出现。
化「字符串」而化「整数」而「爻」文言:头值须可见 ASCII,首尾无空格,长不逾限。汉语:标头值须只含可见 ASCII 字符、首尾不得为空格、长度不超过给定上限。
化「字符串」而「爻」文言:头值至多五一二字节。汉语:标头值的通用校验:上限 512 字节。
化「整数」而「爻」文言:请求 ID 之形,三十六位,惟小写十六进制与短横。汉语:X-Yuyan-Request-ID 的值须恰为 36 个字符,只含小写十六进制数字与连字符。
化「字符串」而「爻」文言:请求 ID 须恰三十六字,小写十六进制与短横。汉语:请求编号须恰为 36 个字符,只含小写十六进制数字与连字符。
化「字符串」而「字符串」文言:文之 JSON 引。汉语:把字符串转成带引号的 JSON 字符串文字。
化「字符串」而「字符串」文言:自 JSON 取字符串。汉语:把 JSON 字符串文字读成字符串,不是字符串则抛豫言异常。
化「字符串」而「整数」文言:自 JSON 取整数。汉语:把 JSON 数字文字读成整数,不是整数则抛豫言异常。
化「字符串」而化(「列」于「字符串」)而「爻」文言:名已在列则阳。汉语:判断名字是否已在列表中出现(用于重名检查)。
化「字符串」而「爻」文言:请头惟 Origin、Content-Type、Cookie。汉语:命名持久服务请求头名的白名单:Origin、Content-Type、Cookie(精确大小写)。
化「字符串」而「爻」文言:对象名之字惟字母数字、下划线、短横与斜线;斜线自〇点三始许,以承旧物「户号/项目号」之名,宿主不以名为径。汉语:对象名中允许的字符:ASCII 字母、数字、下划线、连字符与斜线(0.3.0 起允许斜线,以沿用既有对象的「账户编号/项目编号」名称,宿主不把名称当路径解释)。
化「字符串」而「爻」文言:对象名非空、至多一百二十八字。汉语:对象名非空、不超过 128 字符且只含允许的字符。
化「字符串」而「爻」文言:内址之径须以斜线始,无反斜线、控字、问号、井号。汉语:内部网址的路径:以单个斜线开头,不含反斜线、控制字符、问号、井号。
化「字符串」而化(「列」于(「字符串」合「字符串」))而「有」文言:以 URLSearchParams 追加诸参。汉语:向 URLSearchParams 逐个追加查询参数。
化「字符串」而化(「列」于(「字符串」合「字符串」))而化(「列」于「字符串」)而「有」文言:逐一设请头,验名、重、值。汉语:逐个设置请求头,校验名在白名单、不重复、值合规。
化「字符串」而化「字符串」而化(「列」于(「字符串」合「癸象」))而(「列」于(「字符串」合「癸象」))文言:取一允许之答头入积。汉语:读取一个允许返回的响应头并加入结果列表,没有则不加。
化「字符串」而化「字符串」而化「字符串」而化(「列」于(「字符串」合「字符串」))而化(「列」于(「字符串」合「字符串」))而化「字符串」而「有」文言:先验对象名、内址、法、参、头与正文,违者告事故。汉语:校验命名持久服务请求的公共部分:对象名、内部网址(须为 https://asset/ 或 https://internal/ 开头且路径合规)、方法、查询参数数、请求头数、正文大小(至多 8 MiB)与 GET/HEAD 不带正文;违规抛事故。
化「字符串」而化「字符串」而化(「列」于(「字符串」合「字符串」))而化(「列」于(「字符串」合「字符串」))而化「字符串」而化「字符串」而「字符串」文言:造内请,正文以字节传,不经 JSON 转义;信号号为空则无期限。汉语:构造发往命名持久对象的 Request:查询由 URLSearchParams 编码,请求头逐项校验,POST 正文以字节句柄传入(不经 JSON 转义,故任意字符皆可);信号号非空时挂上中断信号。返回请求句柄。
化「字符串」而化「字符串」而化「字符串」而(「爻」合「字符串」)文言:发请于命名持久对象,待其头。汉语:向授权 DO 绑定内按名取得的对象发请求并等待响应头:返回(成功,响应句柄或“名称: 消息”错误文)。
化「字符串」而化「字符串」而化「字符串」而化「字符串」而化(「列」于(「字符串」合「字符串」))而化(「列」于(「字符串」合「字符串」))而化「字符串」而「字符串」文言:得答则限其长而整读;败或过大皆告事故。汉语:以指定方法请求命名持久对象并读取有限文字响应:正文与响应至多 8 MiB,返回 JSON 文字(status、body、headers 四个允许的小写响应头);传输失败或读取失败抛事故,HTTP 4xx/5xx 仍是成功响应。
化「字符串」而化「字符串」而化「字符串」而化「字符串」而化(「列」于(「字符串」合「字符串」))而化(「列」于(「字符串」合「字符串」))而化「字符串」而化「整数」而(「爻」合「字符串」)文言:发请而不整读,得柄以逐块取;期限贯全程。汉语:以指定方法请求命名持久对象但不整体读取响应:校验同文字版,另加超时毫秒(1 至 900000,覆盖发请和读取响应的整次交换);失败或超时返回阴和原因,成功返回阳和仅本次事件有效的响应柄。
化「字符串」而「爻」文言:转发所保留之头,不缓冲正文,原答直为终答。汉语:允许保留的入站标头名(精确不区分大小写):Accept、Authorization、Content-Type、Cookie、CF-Connecting-IP、Idempotency-Key、If-None-Match、Last-Event-ID、Origin、Range 与 X-Yuyan-*。
化「字符串」而「爻」文言:转发之定头惟 Accept、Content-Type、Origin 与 X-Yuyan-*。汉语:转发入站请求时固定标头名(已转小写)的白名单。
化(「列」于「字符串」)而化(「列」于「字符串」)而(「列」于「字符串」)文言:逐一验保留之头名。汉语:逐项校验要保留的入站标头名:令牌、在白名单、不重复。
化(「列」于(「字符串」合「字符串」))而化(「列」于「字符串」)而(「列」于「字符串」)文言:逐一验转发之定头。汉语:逐项校验转发的固定标头:名在白名单、不与保留名或彼此重复、值合规。
化「字符串」而化(「列」于「字符串」)而化(「列」于「字符串」)而「有」文言:删不在保留名内之头。汉语:从复制来的标头里删掉不在保留名列表内的标头。
化「字符串」而化(「列」于(「字符串」合「字符串」))而「有」文言:书诸定头。汉语:把固定标头逐个写入。
化「字符串」而「字符串」文言:请求已读其体则不可转;无体则空。汉语:读取当前入站请求 body 的句柄;无正文返回空串;正文已被读取或已上锁则抛事故。
化「字符串」而化「字符串」而化「字符串」而化(「列」于(「字符串」合「字符串」))而化(「列」于「字符串」)而化(「列」于(「字符串」合「字符串」))而「有」文言:以当前入站之请转于命名持久对象,其答原样为终答(含事件流);头惟保留所指者与所定者,转址不随。汉语:把当前入站请求(方法、正文流原样,GET/HEAD 不带正文)转发给授权 DO 绑定内按名取得的对象,DO 的响应(含流式 SSE)原样成为当前入站请求的最终响应。只转发 保留名 列出且在白名单内的入站标头,再加固定标头(Accept、Content-Type、Origin、X-Yuyan-*);不跟随重定向;对象名、内部网址、查询规则同 请求命名持久服务文字。
化「字符串」而化「字符串」而「字符串」文言:读答之头,不分大小写,无则空。汉语:读取命名持久服务响应的指定标头值,不区分大小写;缺失返回空字符串;名须是合法标头令牌。
化「字符串」而「整数」文言:读答之状态号。汉语:读取命名持久服务响应的 HTTP 状态码。
化「字符串」而化「整数」而(「整数」合「字符串」)文言:逐块读答文,宿主流式解码,跨块之字自相衔接。汉语:增量读取命名持久服务响应正文的下一块文字,最大字节为 1 至 65536。宿主做流式 UTF-8 解码,跨块多字节字符正确拼接,非法序列成 U+FFFD,文字不含被截断的半个字符,UTF-8 字节数不超过最大字节(小于 4 按 4 计)。状态:0 数据,1 流结束,2 读取错误,3 超时或已取消。
化「字符串」而化「整数」而(「整数」合「字符串」)文言:整读余文,逾限则弃而告过大;先验其声明之长。汉语:一次读完响应剩余正文:状态 0 成功,1 超过字节上限(先看 Content-Length,超限不读;流式累计超限则取消),2 错误,3 超时或已取消。字节上限 1 至 8388608。
化「字符串」而「有」文言:取消则对象闻其取消,幂等。汉语:取消对命名持久服务响应正文的读取并通知对象,重复调用无害。
化「字符串」而「有」文言:以流请所得之答为当前入站请之终答,原样不改;已渐读者告事故。汉语:把 `请求命名持久服务流` 得到的响应(状态、标头、正文流,含 SSE)原样作为当前入站请求的最终响应;已开始增量读取的柄抛豫言异常;一次入站请求只能交付一个最终响应;交付后该柄不可再读(读取得状态 3)。