This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
component:internet [2015/06/16 19:21] gamax92 formatting ... |
component:internet [2019/04/17 21:09] (current) rahix Add id() and the internet_ready event |
||
---|---|---|---|
Line 12: | Line 12: | ||
- `connect(address:string[, port:number]):userdata` | - `connect(address:string[, port:number]):userdata` | ||
Opens a new TCP connection. Returns the handle of the connection. | Opens a new TCP connection. Returns the handle of the connection. | ||
- | - `request(url:string[, postData:string]):userdata` | + | - `request(url:string[, postData:string[, headers:table]]):userdata` |
- | Starts an HTTP request. If this returns true, further results will be pushed using `http_response` signals. | + | Sends a new HTTP request. Returns the handle of the connection. |
+ | |||
+ | ==== TCP Socket Object ==== | ||
+ | |||
+ | - `read([n:number]):string` | ||
+ | Tries to read data from the socket stream. Returns the read byte array. | ||
+ | - `close()` | ||
+ | Closes an open socket stream. | ||
+ | - `write(data:string):number` | ||
+ | Tries to write data to the socket stream. Returns the number of bytes written. | ||
+ | - `finishConnect():boolean` | ||
+ | Ensures a socket is connected. Errors if the connection failed. | ||
+ | - `id():string` | ||
+ | Returns the id for this socket. | ||
+ | |||
+ | 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. | ||
+ | ==== HTTP Request Object ==== | ||
+ | |||
+ | - `read([n:number]):string` | ||
+ | Tries to read data from the response. Returns the read byte array. | ||
+ | - `response():number, string, table` | ||
+ | Get response code, message and headers. | ||
+ | - `close()` | ||
+ | Closes an open socket stream. | ||
+ | - `finishConnect():boolean` | ||
+ | Ensures a response is available. Errors if the connection failed. | ||
---- | ---- | ||
{{page>component:contents&noheader&noeditbutton&nouser&nofooter}} | {{page>component:contents&noheader&noeditbutton&nouser&nofooter}} |