mirror of
https://github.com/SquidDev-CC/CC-Tweaked
synced 2024-12-15 12:40:30 +00:00
895bc7721a
This adds SPDX license headers to all source code files, following the REUSE[1] specification. This does not include any asset files (such as generated JSON files, or textures). While REUSE does support doing so with ".license" files, for now we define these licences using the .reuse/dep5 file. [1]: https://reuse.software/
47 lines
1.3 KiB
Markdown
47 lines
1.3 KiB
Markdown
---
|
|
module: [kind=event] http_failure
|
|
see: http.request To send an HTTP request.
|
|
---
|
|
|
|
<!--
|
|
SPDX-FileCopyrightText: 2021 The CC: Tweaked Developers
|
|
|
|
SPDX-License-Identifier: LicenseRef-CCPL
|
|
-->
|
|
|
|
The @{http_failure} event is fired when an HTTP request fails.
|
|
|
|
This event is normally handled inside @{http.get} and @{http.post}, but it can still be seen when using @{http.request}.
|
|
|
|
## Return Values
|
|
1. @{string}: The event name.
|
|
2. @{string}: The URL of the site requested.
|
|
3. @{string}: An error describing the failure.
|
|
4. <span class="type">@{http.Response}|@{nil}</span>: A response handle if the connection succeeded, but the server's
|
|
response indicated failure.
|
|
|
|
## Example
|
|
Prints an error why the website cannot be contacted:
|
|
```lua
|
|
local myURL = "https://does.not.exist.tweaked.cc"
|
|
http.request(myURL)
|
|
local event, url, err
|
|
repeat
|
|
event, url, err = os.pullEvent("http_failure")
|
|
until url == myURL
|
|
print("The URL " .. url .. " could not be reached: " .. err)
|
|
```
|
|
|
|
Prints the contents of a webpage that does not exist:
|
|
```lua
|
|
local myURL = "https://tweaked.cc/this/does/not/exist"
|
|
http.request(myURL)
|
|
local event, url, err, handle
|
|
repeat
|
|
event, url, err, handle = os.pullEvent("http_failure")
|
|
until url == myURL
|
|
print("The URL " .. url .. " could not be reached: " .. err)
|
|
print(handle.getResponseCode())
|
|
handle.close()
|
|
```
|