performs a download to in the background, calling the eventFunction when an event is raised.

Details and OptionsDetails and Options

  • Types of events that may be raised:
  • "data"returns an empty list; can be used to indicate the connection has completed
    "progress"returns information about the current connection of the form
    "error"indicates that an error occurred while attempting to connect to the URL
    "headers"headers received from the web server
    "cookies"a list of all known cookies
    "statuscode"the status code returned by the server
  • The following options can be given:
  • Method"GET"method to use for request
    "Parameters"{}parameters to be sent for the request
    "BodyData"""contents of message body to be sent
    "MultipartData"{}list of multipart data elements to send
    "Username"""username to use for the request
    "Password"""password to use for the request
    "Headers"{}headers to be manually sent to the HTTP server
    "Cookies"Truewhether to store received cookies
    "StoreCookies"Automaticcookies to pass to the server
    "VerifyPeer"Trueverify authenticity using SSL certificates
    "UserAgent"Automaticuser agent string to send
    "ReadTimeout"0time to allow for uploading or downloading data
    "ConnectTimeout"0time to allow for connecting to the server
    "Progress"Falsewhether to raise a event
    "Transfer"Automaticif Automatic, the event returns once, and returns all the data downloaded; if , the event is raised multiple times with the data downloaded since the last event was raised
    "UserData"Noneany expression passed to this option will be stored for use of the AsynchronousTaskObject inside the event function; the data can be found by checking the options of AsynchronousTaskObject passed to the event function
    BinaryFormatTruewhether to avoid textual interpretation of newlines or other data
  • When an event is raised, the event function passed to URLSaveAsynchronous will be executed. The event functions will be passed three arguments, the AsynchronousTaskObject, the event name, and the data received from the event. Event functions are the only method for handling data received from URLSaveAsynchronous.
Introduced in 2012