Response

Response用于封装MNConnection.fetchDev系列方法的响应结果，提供状态字段、头管理和正文解析方法。

构造函数

new Response(data?: NSData|null,init?: {
  status?: number
  statusText?: string
  headers?: Headers|Array<[string,string]>|Record<string,string>
  type?: string
  url?: string
  redirected?: boolean
  error?: string
})

构造一个新的Response实例。

参数名	类型	必填	说明
`data`	`NSData\|null`	否	响应体数据。传`null`表示空响应体。
`init`	`object`	否	响应元信息配置。

类成员(Class members)

属性

无。

方法

`redirect`

类型

static redirect(url: string,status?: number): Response

说明

创建一个重定向响应对象，仅允许301、302、303、307、308状态码。

参数

参数名	类型	必填	说明
`url`	`string`	是	重定向目标地址。
`status`	`number`	否	重定向状态码，默认302。

返回值

类型:Response
语义:返回新的重定向响应对象。

`error`

类型

static error(): Response

说明

创建一个错误响应对象，状态码固定为0，type固定为error。

参数

无。

返回值

类型:Response
语义:返回错误响应对象。

`new`

类型

static new(res: NSHTTPURLResponse,data: NSData,err: NSError,url?: string): Response

说明

把原生网络回调参数封装为Response对象。

参数

参数名	类型	必填	说明
`res`	`NSHTTPURLResponse`	是	原生响应对象。
`data`	`NSData`	是	原始响应体。
`err`	`NSError`	是	原生错误对象。
`url`	`string`	否	请求URL。

返回值

类型:Response
语义:返回封装后的响应对象。

实例成员(Instance members)

属性

`hasJSONResult`

类型

get hasJSONResult(): boolean

说明

判断当前响应体是否可解析为非空JSON对象。

返回值

类型:boolean
语义:可解析且非空时返回true。

方法

`copy`

类型

copy(): void

说明

把asJSONObject()结果复制到剪贴板，便于调试查看。

参数

无。

返回值

类型:void
语义:无返回值。

`asJSONObject`

类型

asJSONObject(): {
  status: number
  statusText: string
  statusCodeDescription: string
  headers: Headers
  type: string
  url: string
  error?: string
  text?: string|Promise<string>
  json?: any
  bodySize?: number
}|undefined

说明

将当前响应转为便于展示和记录的结构化对象。

参数

无。

返回值

类型:object|undefined
语义:成功时返回结构化对象，异常时返回undefined。

`_parseBody`

类型

_parseBody(body: Uint8Array|string|FormData|null): Uint8Array|null

说明

将不同输入体归一化为Uint8Array。

参数

参数名	类型	必填	说明
`body`	`Uint8Array\|string\|FormData\|null`	是	待转换的输入体。

返回值

类型:Uint8Array|null
语义:可解析时返回字节数组，否则返回null。

`_setBodyUsed`

类型

_setBodyUsed(): void

说明

内部标记方法。当前实现中该方法提前返回，不会真正改变_bodyUsed。

参数

无。

返回值

类型:void
语义:无返回值。

`arrayBuffer`

类型

arrayBuffer(): Promise<ArrayBuffer>

说明

将响应体转换为ArrayBuffer。

参数

无。

返回值

类型:Promise<ArrayBuffer>
语义:返回异步数组缓冲区结果。

`blob`

类型

blob(): Promise<Blob>

说明

将响应体转换为Blob，并携带content-type头中的MIME类型。

参数

无。

返回值

类型:Promise<Blob>
语义:返回异步Blob结果。

`json`

类型

json(): any

说明

将响应体解析为JSON对象。解析失败时返回SyntaxError对象。

参数

无。

返回值

类型:any
语义:通常为JSON对象，失败时为错误对象。

`text`

类型

text(): string|Promise<string>

说明

将响应体转换为字符串。无响应体时返回空字符串Promise。

参数

无。

返回值

类型:string|Promise<string>
语义:返回文本结果或其Promise。

`formData`

类型

formData(): Promise<FormData>

说明

把application/x-www-form-urlencoded形式文本解析为FormData。

参数

无。

返回值

类型:Promise<FormData>
语义:返回异步FormData结果。

`clone`

类型

clone(): Response

说明

克隆当前响应对象。若响应体已被消费会抛出TypeError。

参数

无。

返回值

类型:Response
语义:返回克隆后的新响应对象。

头文件API清单

正在加载...

协议：JSBResponse，来源：-

On this page