This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
component:internet:zh [2023/11/05 10:37] hfsr created |
component:internet:zh [2023/11/05 10:56] hfsr [HTTP请求对象] |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | Component: Internet | + | 组件:因特网 |
=================== | =================== | ||
- | This component is provided by the [[item:internet_card|Internet Card]] | + | 此组件由[[item:internet_card:zh|因特网卡]]提供。 |
- | Component name: `internet`. | + | 组件名:`internet`。 |
- | Callbacks: | + | |
+ | 回调函数: | ||
- `isTcpEnabled():boolean` | - `isTcpEnabled():boolean` | ||
- | Returns whether TCP connections can be made (config setting). | + | 返回是否可建立TCP连接(可在配置文件中设置)。 |
+ | \\ | ||
- `isHttpEnabled():boolean` | - `isHttpEnabled():boolean` | ||
- | Returns whether HTTP requests can be made (config setting). | + | 返回是否可进行HTTP请求(可在配置文件中设置)。 |
+ | \\ | ||
- `connect(address:string[, port:number]):userdata` | - `connect(address:string[, port:number]):userdata` | ||
- | Opens a new TCP connection. Returns the handle of the connection. | + | 建立一个新的TCP连接。返回连接的句柄。 |
+ | \\ | ||
- `request(url:string[, postData:string[, headers:table]]):userdata` | - `request(url:string[, postData:string[, headers:table]]):userdata` | ||
- | Sends a new HTTP request. Returns the handle of the connection. | + | 发送一个新的HTTP请求。返回连接的句柄。 |
- | ==== TCP Socket Object ==== | + | ====TCP套接字对象==== |
- `read([n:number]):string` | - `read([n:number]):string` | ||
- | Tries to read data from the socket stream. Returns the read byte array. | + | 尝试从套接字流中读取数据。返回读取到的字节数组。 |
+ | \\ | ||
- `close()` | - `close()` | ||
- | Closes an open socket stream. | + | 关闭某个已打开的套接字流。 |
+ | \\ | ||
- `write(data:string):number` | - `write(data:string):number` | ||
- | Tries to write data to the socket stream. Returns the number of bytes written. | + | 尝试向套接字流中写入数据。返回写入的字节数。 |
+ | \\ | ||
- `finishConnect():boolean` | - `finishConnect():boolean` | ||
- | Ensures a socket is connected. Errors if the connection failed. | + | 确认套接字已连接。若连接失败会报错。 |
- | - `id():string` | + | \\ |
- | Returns the id for this socket. | + | - `id():string` |
+ | 返回此套接字的ID。 | ||
- | After calling `finishConnect` or `read`, this socket generates a signal named `internet_ready` whenever new data is available to be read. It has one parameter which is the socket id. | + | 在调用`finishConnect`或者`read`后,套接字会在有新数据可供读取时产生一个名为`internet_ready`的信号。此信号有一个参数,代表套接字ID。 |
- | ==== HTTP Request Object ==== | + | ====HTTP请求对象==== |
- `read([n:number]):string` | - `read([n:number]):string` | ||
- | Tries to read data from the response. Returns the read byte array. | + | 尝试从响应中读取数据。返回读取到的字节数组。 |
+ | \\ | ||
- `response():number, string, table` | - `response():number, string, table` | ||
- | Get response code, message and headers. | + | 获取响应码、响应信息与响应头。 |
+ | \\ | ||
- `close()` | - `close()` | ||
- | Closes an open socket stream. | + | 关闭某个已打开的套接字流。 |
+ | \\ | ||
- `finishConnect():boolean` | - `finishConnect():boolean` | ||
- | Ensures a response is available. Errors if the connection failed. | + | 确认套接字已连接。若连接失败会报错。 |
目录 | 目录 |