Revision Difference
http.Fetch#518575
<function name="Fetch" parent="http" type="libraryfunc">
<description>Launches a GET request.</description>
<realm>Shared and Menu</realm>
<file line="18-L44">lua/includes/modules/http.lua</file>
<args>
<arg name="url" type="string">The URL of the website to fetch.</arg>
<arg name="onSuccess" type="function" default="nil">Function to be called on success. Arguments are
* <page>string</page> body
* <page>string</page> size - equal to <page>string.len(body)</page>
* <page>table</page> headers
* <page>number</page> code - The HTTP success code</arg>⤶
<arg name="onFailure" type="function" default="nil">Function to be called on failure. Arguments are
* <page>string</page> error - The error message</arg>⤶
<arg name="onSuccess" type="function" default="nil">Function to be called on success. Arguments are⤶
* <page>string</page> body⤶
* <page>string</page> size - equal to <page>string.len(body)</page>⤶
* <page>table</page> headers⤶
* <page>number</page> code - The HTTP success code</arg>⤶
<arg name="onFailure" type="function" default="nil">Function to be called on failure. Arguments are⤶
* <page>string</page> error - The error message</arg>⤶
<arg name="headers" type="table" default="{}">KeyValue table for headers</arg>
</args>
</function>
<example>
<description>Shows the typical usage to get the HTML of a webpage.</description>
<code>
local TheReturnedHTML = "" -- Blankness
http.Fetch( "http:&#47;&#47;www.google.com",
http.Fetch( "http://www.google.com",
function( body, len, headers, code )
-- The first argument is the HTML we asked for.
TheReturnedHTML = body
end,
function( error )
-- We failed. =(
end
)
</code>
<output>If it successfully fetched the page, the variable 'TheReturnedHTML' should contain the returned HTML in plain text.</output>
</example>