Next: Supported URL Types, Previous: Getting Started, Up: Top

## 2 Retrieving URLs

— Function: url-retrieve-synchronously url

> Retrieve url synchronously and return a buffer containing the data. url is either a string or a parsed URL structure. Return `nil` if there are no data associated with it (the case for dired, info, or mailto URLs that need no further processing).

— Function: url-retrieve url callback &optional cbargs

> Retrieve url asynchronously and call callback with args cbargs when finished. The callback is called when the object has been completely retrieved, with the current buffer containing the object and any MIME headers associated with it. url is either a string or a parsed URL structure. Returns the buffer url will load into, or `nil` if the process has already completed.