@spcsn/taro 0.1.0

package/types/api/network/request.d.ts

@@ -0,0 +1,480 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  namespace request {
+    interface Option<T = any, U extends string | TaroGeneral.IAnyObject | ArrayBuffer = any | any> {
+      /** 开发者服务器接口地址 */
+      url: string
+      /** 请求的参数 */
+      data?: U
+      /** 设置请求的 header，header 中不能设置 Referer。
+       *
+       * `content-type` 默认为 `application/json`
+       */
+      header?: TaroGeneral.IAnyObject
+      /** 超时时间，单位为毫秒
+       * @default 60000
+       * @supported weapp, h5, tt, alipay, rn
+       */
+      timeout?: number
+      /** HTTP 请求方法
+       * @default "GET"
+       */
+      method?: keyof Method
+      /** 返回的数据格式 */
+      dataType?: keyof DataType | string
+      /** 响应的数据类型 */
+      responseType?: keyof ResponseType
+      /**
+       * 使用高性能模式。从基础库 v3.5.0 开始在 Android 端默认开启，其他端暂不生效。该模式下有更优的网络性能表现。
+       * @default true
+       * */
+      useHighPerformanceMode?: boolean
+      /** 开启 http2
+       * @default false
+       * @supported weapp
+       */
+      enableHttp2?: boolean
+      /** 开启 quic
+       * @default false
+       * @supported weapp
+       */
+      enableQuic?: boolean
+      /** 开启 cache
+       * @default false
+       * @supported weapp, tt
+       */
+      enableCache?: boolean
+      /** 是否开启 HttpDNS 服务。如开启，需要同时填入 httpDNSServiceId 。 HttpDNS 用法详见 移动解析HttpDNS
+       * @default false
+       * @supported weapp
+       */
+      enableHttpDNS?: boolean
+      /** HttpDNS 服务商 Id。 HttpDNS 用法详见 移动解析HttpDNS
+       * @supported weapp
+       */
+      httpDNSServiceId?: string
+      /** 开启 transfer-encoding chunked。
+       * @default false
+       * @supported weapp
+       */
+      enableChunked?: boolean
+      /**
+       * wifi下使用移动网络发送请求
+       * @default false
+       * @supported weapp
+       */
+      forceCellularNetwork?: boolean
+      /**
+       * headers 中设置 cookie 字段是否生效。如果为 false，则 headers 中的 cookie 字段将被忽略，请求头中将包含服务端上一次返回的 cookie（如果有）。
+       * @default false
+       * @supported alipay 支付宝: 10.2.33+
+       */
+      enableCookie?: boolean
+      /**
+       * referer 策略，用于控制当前请求 header 对象中 referer 字段格式。该参数默认值可通过 app.json 中的配置进行修改。
+       * @default "querystring"
+       * @supported alipay 支付宝: 10.3.50+ APPX: 2.8.7 开发者工具: 3.5.1
+       * @see https://opendocs.alipay.com/mini/api/owycmh#referrerStrategy%20%E5%8F%82%E6%95%B0%E8%AF%B4%E6%98%8E
+       */
+      referrerStrategy?: keyof ReferrerStrategy
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult<T>) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: Partial<SuccessCallbackResult> & TaroGeneral.CallbackResult) => void
+      /** 设置是否使用 jsonp 方式获取数据
+       * @default false
+       * @supported h5
+       */
+      jsonp?: boolean | string
+      /** 设置 jsonp 请求 url 是否需要被缓存
+       * @supported h5
+       */
+      jsonpCache?: RequestCache
+      /** 设置是否允许跨域请求
+       * @default "same-origin"
+       * @supported h5
+       */
+      mode?: keyof CorsMode
+      /** 设置是否携带 Cookie
+       * @default "omit"
+       * @supported h5
+       */
+      credentials?: keyof Credentials
+      /** 设置缓存模式
+       * @default "default"
+       * @supported h5
+       */
+      cache?: keyof Cache
+      /** 设置请求重试次数
+       * @default 2
+       * @supported h5
+       * @h5 仅在 jsonp 模式下生效
+       */
+      retryTimes?: number
+      /** 设置请求的兜底接口
+       * @supported h5
+       * @h5 仅在 jsonp 模式下生效
+       */
+      backup?: string | string[]
+      /** 设置请求中止信号
+       * @supported h5
+       */
+      signal?: AbortSignal
+      /** 设置请求响应的数据校验函数，若返回 false，则请求兜底接口，若无兜底接口，则报请求失败
+       * @supported h5
+       * @h5 仅在 jsonp 模式下生效
+       */
+      dataCheck?(): boolean
+      /** 设置请求是否使用缓存
+       * @default false
+       * @supported h5
+       * @h5 仅在 jsonp 模式下生效
+       */
+      useStore?: boolean
+      /** 设置请求缓存校验的 key
+       * @supported h5
+       * @h5 仅在 jsonp 模式下生效
+       */
+      storeCheckKey?: string
+      /** 设置请求缓存签名
+       * @supported h5
+       * @h5 仅在 jsonp 模式下生效
+       */
+      storeSign?: string
+      /** 设置请求校验函数，一般不需要设置
+       * @supported h5
+       */
+      storeCheck?(): boolean
+    }
+
+    interface SuccessCallbackResult<T extends string | TaroGeneral.IAnyObject | ArrayBuffer = any | any>
+      extends TaroGeneral.CallbackResult {
+      /** 开发者服务器返回的数据 */
+      data: T
+      /** 开发者服务器返回的 HTTP Response Header */
+      header: TaroGeneral.IAnyObject
+      /** 开发者服务器返回的 HTTP 状态码 */
+      statusCode: number
+      /** 调用结果 */
+      errMsg: string
+      /** cookies */
+      cookies?: string[]
+    }
+
+    /** 返回的数据格式 */
+    interface DataType {
+      /**
+       * 返回的数据为 JSON，返回后会对返回的数据进行一次 JSON.parse
+       * 其他: 不对返回的内容进行 JSON.parse
+       */
+      json
+      /**
+       * 返回的数据为文本字符串
+       * @supported alipay
+       */
+      text
+      /**
+       * 返回的数据将转换为 base64 格式字符串
+       * @supported alipay
+       */
+      base64
+      /**
+       * 返回的数据将保持 ArrayBuffer 数据
+       * @supported alipay 支付宝: 10.1.70+
+       */
+      arraybuffer
+    }
+
+    /** HTTP 请求方法 */
+    interface Method {
+      /** HTTP 请求 OPTIONS */
+      OPTIONS
+      /** HTTP 请求 GET */
+      GET
+      /** HTTP 请求 HEAD */
+      HEAD
+      /** HTTP 请求 POST */
+      POST
+      /** HTTP 请求 PUT */
+      PUT
+      /** HTTP 请求 PATCH */
+      PATCH
+      /** HTTP 请求 DELETE */
+      DELETE
+      /** HTTP 请求 TRACE */
+      TRACE
+      /** HTTP 请求 CONNECT */
+      CONNECT
+    }
+
+    /** 响应的数据类型 */
+    interface ResponseType {
+      /** 响应的数据为文本 */
+      text
+      /** 响应的数据为 ArrayBuffer */
+      arraybuffer
+    }
+
+    /** 跨域策略 */
+    interface CorsMode {
+      /** 跨域请求将获取不透明的响应 */
+      'no-cors'
+      /** 允许跨域请求 */
+      cors
+      /** 请求总是向当前的源发起的 */
+      'same-origin'
+    }
+    /** 证书 */
+    interface Credentials {
+      /** 不论是不是跨域的请求,总是发送请求资源域在本地的 cookies、 HTTP Basic authentication 等验证信息 */
+      include
+      /** 只有当URL与响应脚本同源才发送 cookies、 HTTP Basic authentication 等验证信息 */
+      'same-origin'
+      /** 从不发送cookies */
+      omit
+    }
+    /** 缓存策略 */
+    interface Cache {
+      /** 浏览器从HTTP缓存中寻找匹配的请求 */
+      default
+      /** 浏览器在其HTTP缓存中寻找匹配的请求 */
+      'no-cache'
+      /** 浏览器直接从远程服务器获取资源，不查看缓存，然后使用下载的资源更新缓存 */
+      reload
+      /** 浏览器在其HTTP缓存中寻找匹配的请求 */
+      'force-cache'
+      /** 浏览器在其HTTP缓存中寻找匹配的请求 */
+      'only-if-cached'
+    }
+    /** referer 策略 */
+    interface ReferrerStrategy {
+      /**
+       * referer 值为 https://{appid}.hybrid.alipay-eco.com/{appid}/{version}/index.html
+       */
+      index
+      /**
+       * 保留 page（pages/xxx/yyy），referer 值为 https://{appid}.hybrid.alipay-eco.com/{appid}/{version}/index.html#{page}
+       */
+      page
+      /**
+       * 默认值。会将发起请求时所在页面的 URL 作为 referer 值，会保留 page（pages/xxx/yyy）和 querystring（x=1&y=2）并可能有框架添加的其他参数，referer 值为 https://{appid}.hybrid.alipay-eco.com/{appid}/{version}/index.html#{page}?{querysrtring}{框架其他参数}
+       */
+      querystring
+    }
+  }
+
+  /** 网络请求任务对象
+   * @supported weapp, h5, rn, alipay, swan, tt, qq, harmony_hybrid
+   * @example
+   * 回调函数(Callback)用法：
+   *
+   * ```tsx
+   * const requestTask = Taro.request({
+   *   url: 'test.php', //仅为示例，并非真实的接口地址
+   *   data: {
+   *     x: '' ,
+   *     y: ''
+   *   },
+   *   header: {
+   *     'content-type': 'application/json' // 默认值
+   *   },
+   *   success: function (res) {
+   *     console.log(res.data)
+   *   }
+   * })
+   * requestTask.abort()
+   * ```
+   * @example
+   * Promise 用法：
+   *
+   * ```tsx
+   * const requestTask = Taro.request({
+   *   url: 'test.php', //仅为示例，并非真实的接口地址
+   *   data: {
+   *     x: '' ,
+   *     y: ''
+   *   },
+   *   header: {
+   *     'content-type': 'application/json' // 默认值
+   *   },
+   *   success: function (res) {
+   *     console.log(res.data)
+   *   }
+   * })
+   * requestTask.then(res => {
+   *   console.log(res.data)
+   * })
+   * requestTask.abort()
+   * ```
+   * @example
+   * async/await 用法：
+   *
+   * ```tsx
+   * const requestTask = Taro.request(params)
+   * const res = await requestTask
+   * requestTask.abort()
+   * ```
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/request/RequestTask.html
+   */
+  interface RequestTask<T> extends Promise<request.SuccessCallbackResult<T>> {
+    /** 中断请求任务
+     * @supported weapp, tt, harmony_hybrid
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/request/RequestTask.abort.html
+     */
+    abort(): void
+    /** 监听 HTTP Response Header 事件。会比请求完成事件更早
+     * @supported weapp, harmony_hybrid
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/request/RequestTask.onHeadersReceived.html
+     */
+    onHeadersReceived(
+      /** HTTP Response Header 事件的回调函数 */
+      callback: RequestTask.onHeadersReceived.Callback
+    ): void
+    /** 取消监听 HTTP Response Header 事件
+     * @supported weapp, harmony_hybrid
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/request/RequestTask.offHeadersReceived.html
+     */
+    offHeadersReceived(
+      /** HTTP Response Header 事件的回调函数 */
+      callback: RequestTask.onHeadersReceived.Callback
+    ): void
+    /** 监听 Transfer-Encoding Chunk Received 事件。当接收到新的chunk时触发。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/request/RequestTask.onChunkReceived.html
+     */
+    onChunkReceived(
+      /** Transfer-Encoding Chunk Received 事件的回调函数 */
+      callback: RequestTask.onChunkReceived.Callback
+    ): void
+    /** 移除 Transfer-Encoding Chunk Received 事件的监听函数
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/request/RequestTask.offChunkReceived.html
+     */
+    offChunkReceived(
+      /** Transfer-Encoding Chunk Received 事件的回调函数 */
+      callback: RequestTask.onChunkReceived.Callback
+    ): void
+  }
+
+  namespace RequestTask {
+    namespace onHeadersReceived {
+      /** HTTP Response Header 事件的回调函数 */
+      type Callback = (result: CallbackResult) => void
+      interface CallbackResult {
+        /** 开发者服务器返回的 HTTP Response Header */
+        header: TaroGeneral.IAnyObject
+      }
+    }
+    namespace onChunkReceived {
+      /** Transfer-Encoding Chunk Received 事件的回调函数 */
+      type Callback = (result: CallbackResult) => void
+      /** 开发者服务器每次返回新 chunk 时的 Response */
+      interface CallbackResult {
+        /** 返回的chunk buffer */
+        data: ArrayBuffer
+      }
+    }
+  }
+
+  /** @ignore */
+  type interceptor = (chain: Chain) => any
+
+  /** @ignore */
+  interface Chain {
+    index: number
+    requestParams: RequestParams
+    interceptors: interceptor[]
+    proceed(requestParams: RequestParams): any
+  }
+
+  /** @ignore */
+  interface interceptors {
+    logInterceptor(chain: Chain): Promise<any>
+
+    timeoutInterceptor(chain: Chain): Promise<any>
+  }
+
+  interface TaroStatic {
+    /** 发起 HTTPS 网络请求。使用前请注意阅读[相关说明](https://developers.weixin.qq.com/miniprogram/dev/framework/ability/network.html)。
+     *
+     * **data 参数说明**
+     * 最终发送给服务器的数据是 String 类型，如果传入的 data 不是 String 类型，会被转换成 String 。转换规则如下：
+     * - 对于 `GET` 方法的数据，会将数据转换成 query string（`encodeURIComponent(k)=encodeURIComponent(v)&encodeURIComponent(k)=encodeURIComponent(v)...`）
+     * - 对于 `POST` 方法且 `header['content-type']` 为 `application/json` 的数据，会对数据进行 JSON 序列化
+     * - 对于 `POST` 方法且 `header['content-type']` 为 `application/x-www-form-urlencoded` 的数据，会将数据转换成 query string `（encodeURIComponent(k)=encodeURIComponent(v)&encodeURIComponent(k)=encodeURIComponent(v)...）`
+     * @supported weapp, h5, rn, alipay, swan, tt, qq, harmony, harmony_hybrid
+     * @example
+     * ```tsx
+     * Taro.request({
+     *   url: 'test.php', //仅为示例，并非真实的接口地址
+     *   data: {
+     *     x: '',
+     *     y: ''
+     *   },
+     *   header: {
+     *     'content-type': 'application/json' // 默认值
+     *   },
+     *   success: function (res) {
+     *     console.log(res.data)
+     *   }
+     * })
+     * ```
+     * @example
+     * async/await 用法：
+     *
+     * ```tsx
+     * const res = await Taro.request(params)
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/request/wx.request.html
+     */
+    request<T = any, U = any>(option: request.Option<T, U>): RequestTask<T>
+
+    /** 可以使用拦截器在请求发出前或发出后做一些额外操作。
+     *
+     * 在调用 `Taro.request` 发起请求之前，调用 `Taro.addInterceptor` 方法为请求添加拦截器，拦截器的调用顺序遵循洋葱模型。
+     * 拦截器是一个函数，接受 chain 对象作为参数。chain 对象中含有 **requestParmas** 属性，代表请求参数。拦截器内最后需要调用 `chain.proceed(requestParams)` 以调用下一个拦截器或发起请求。
+     *
+     * Taro 提供了两个内置拦截器 `logInterceptor` 与 `timeoutInterceptor`，分别用于打印请求的相关信息和在请求超时时抛出错误。
+     * @supported weapp, h5, alipay, swan, tt, qq
+     * @example
+     * ```tsx
+     * const interceptor = function (chain) {
+     *   const requestParams = chain.requestParams
+     *   const { method, data, url } = requestParams
+     *
+     *   console.log(`http ${method || 'GET'} --> ${url} data: `, data)
+     *
+     *   return chain.proceed(requestParams)
+     *     .then(res => {
+     *       console.log(`http <-- ${url} result:`, res)
+     *       return res
+     *     })
+     *   }
+     * Taro.addInterceptor(interceptor)
+     * Taro.request({ url })
+     * ```
+     * @example
+     * ```tsx
+     * Taro.addInterceptor(Taro.interceptors.logInterceptor)
+     * Taro.addInterceptor(Taro.interceptors.timeoutInterceptor)
+     * Taro.request({ url })
+     * ```
+     * @since 1.2.16
+     */
+    addInterceptor(interceptor: interceptor): any
+
+    /** 清除所有拦截器
+     * @example
+     * ```tsx
+     * Taro.cleanInterceptors()
+     * ```
+     * @supported weapp, h5, alipay, swan, tt, qq
+     */
+    cleanInterceptors(): void
+
+    interceptors: interceptors
+  }
+}

package/types/api/network/tcp.d.ts

@@ -0,0 +1,181 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  /** 一个 TCP Socket 实例，默认使用 IPv4 协议
+   * @supported weapp
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/tcp/TCPSocket.html
+   */
+  interface TCPSocket {
+    /** 在给定的套接字上启动连接
+     * @supported weapp
+     * @example
+     * ```tsx
+     * const tcp = Taro.createTCPSocket()
+     * tcp.connect({ address: '192.168.193.2', port: 8848 })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/tcp/TCPSocket.connect.html
+     */
+    connect(option: TCPSocket.connect.Option): void
+    /** 在 socket 上发送数据
+     * @supported weapp
+     * @example
+     * ```tsx
+     * const tcp = Taro.createTCPSocket()
+     * tcp.write('hello, how are you')
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/tcp/TCPSocket.write.html
+     */
+    write(
+      /** 要发送的数据 */
+      data: string | ArrayBuffer
+    ): void
+    /** 关闭连接
+     * @supported weapp
+     * @example
+     * ```tsx
+     * const tcp = Taro.createTCPSocket()
+     * tcp.close()
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/tcp/TCPSocket.close.html
+     */
+    close(): void
+    /** 监听关闭事件
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/tcp/TCPSocket.onClose.html
+     */
+    onClose(
+      /** 当一个 socket 完全关闭就发出该事件的回调函数 */
+      callback: TCPSocket.onClose.Callback,
+    ): void
+    /** 取消监听当一个 socket 完全关闭就发出该事件
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/tcp/TCPSocket.offClose.html
+     */
+    offClose(
+      /** 当一个 socket 完全关闭就发出该事件的回调函数 */
+      callback: TCPSocket.onClose.Callback,
+    ): void
+    /** 监听当一个 socket 连接成功建立的时候触发该事件
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/tcp/TCPSocket.onConnect.html
+     */
+    onConnect(
+      /** 当一个 socket 连接成功建立的时候触发该事件的回调函数 */
+      callback: TCPSocket.onConnect.Callback,
+    ): void
+    /** 取消监听当一个 socket 连接成功建立的时候触发该事件
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/tcp/TCPSocket.offConnect.html
+     */
+    offConnect(
+      /** 当一个 socket 连接成功建立的时候触发该事件的回调函数 */
+      callback: TCPSocket.onConnect.Callback,
+    ): void
+    /** 监听当错误发生时触发
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/tcp/TCPSocket.onError.html
+     */
+    onError(
+      /** 监听当错误发生时触发的回调函数 */
+      callback: TCPSocket.onError.Callback,
+    ): void
+    /** 取消监听当错误发生时触发
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/tcp/TCPSocket.offError.html
+     */
+    offError(
+      /** 监听当错误发生时触发的回调函数 */
+      callback: TCPSocket.onError.Callback,
+    ): void
+    /** 监听当接收到数据的时触发该事件
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/tcp/TCPSocket.onMessage.html
+     */
+    onMessage(
+      /** 当接收到数据的时触发该事件的回调函数 */
+      callback: TCPSocket.onMessage.Callback,
+    ): void
+    /** 取消监听当接收到数据的时触发该事件
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/tcp/TCPSocket.offMessage.html
+     */
+    offMessage(
+      /** 当接收到数据的时触发该事件的回调函数 */
+      callback: TCPSocket.onMessage.Callback,
+    ): void
+  }
+
+  namespace TCPSocket {
+    namespace connect {
+      interface Option {
+        /** 套接字要连接的地址 */
+        address: string
+        /** 套接字要连接的端口 */
+        port: number
+      }
+    }
+    namespace onClose {
+      /** 当一个 socket 完全关闭就发出该事件的回调函数 */
+      type Callback = (...args: unknown[]) => void
+    }
+    namespace onConnect {
+      /** 当一个 socket 连接成功建立的时候触发该事件的回调函数 */
+      type Callback = (...args: unknown[]) => void
+    }
+    namespace onError {
+      /** 监听当错误发生时触发的回调函数 */
+      type Callback = (result: CallbackResult) => void
+      interface CallbackResult extends TaroGeneral.CallbackResult {
+        /** 错误信息 */
+        errMsg: string
+      }
+    }
+    namespace onMessage {
+      /** 当接收到数据的时触发该事件的回调函数 */
+      type Callback = (result: CallbackResult) => void
+      interface CallbackResult extends TaroGeneral.CallbackResult {
+        /** 收到的消息 */
+        message: ArrayBuffer
+        /** 发送端地址信息 */
+        remoteInfo: RemoteInfo
+        /** 接收端地址信息 */
+        localInfo: LocalInfo
+      }
+      /** 发送端地址信息 */
+      interface RemoteInfo {
+        /** 发送消息的 socket 的地址 */
+        address: string
+        /** 使用的协议族，为 IPv4 或者 IPv6 */
+        family: string
+        /** 端口号 */
+        port: number
+        /** message 的大小，单位：字节 */
+        size: number
+      }
+      /** 接收端地址信息 */
+      interface LocalInfo {
+        /** 接收消息的 socket 的地址 */
+        address: string
+        /** 使用的协议族，为 IPv4 或者 IPv6 */
+        family: string
+        /** 端口号 */
+        port: number
+      }
+    }
+  }
+
+  interface TaroStatic {
+    /** 创建一个 TCP Socket 实例。使用前请注意阅读[相关说明](https://developers.weixin.qq.com/miniprogram/dev/framework/ability/network.html)。
+     *
+     * **连接限制**
+     *
+     * - 允许与局域网内的非本机 IP 通信
+     * - 允许与配置过的服务器域名通信，详见[相关说明](https://developers.weixin.qq.com/miniprogram/dev/framework/ability/network.html)
+     * - 禁止与以下端口号连接：1024 以下 1099 1433 1521 1719 1720 1723 2049 2375 3128 3306 3389 3659 4045 5060 5061 5432 5984 6379 6000 6566 7001 7002 8000-8100 8443 8888 9200 9300 10051 10080 11211 27017 27018 27019
+     * - 每 5 分钟内最多创建 20 个 TCPSocket
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/tcp/wx.createTCPSocket.html
+     */
+    createTCPSocket(): TCPSocket
+  }
+}