libURLErrorData

returns any error that was caused during a download that was started with the load command.

# Metadata

Platforms: desktop, server OS: mac, windows, linux, web Introduced: 1.1.1 Security: network

# Syntax

libURLErrorData(url)

# Params

- url : A URL, or an expression that evaluates to a URL.

# Examples

put libURLErrorData("http://www.example.org/index.html") into myErr

if libURLErrorData(it) contains "404" then answer "File doesn't exist!"

if libURLStatus(myURL) is "error" then return libURLErrorData(myURL)

# Description

Use the libURLErrorData function to check the error status of a download.

If the download failed because of a server error--for example, if a requested web page was not found--the libURLErrorData function returns the error message sent by the server. If the download failed for another reason--for example, if the server did not respond, or if an invalid URL was supplied--the libURLErrorData function returns an error message generated by the Internet library.

>*Important:* The libURLErrorData function is part of the > Internet library. To ensure that the function works in a > standalone application, you must include this > LiveCode custom library when you create your > standalone application. In the Inclusions pane of the > Standalone Application Settings window, make sure the "Internet" > script library is selected.

# Tags

networking,

# See

- **keyword:** https, ftp, URL, http - **glossary:** LiveCode custom library, return, Standalone Application Settings, download, cache, standalone application, command, server - **command:** libURLSetLogField, load - **function:** libURLErrorData, cachedURLs, URLStatus - **library:** Internet library - **control structure:** function