load_html()

From KoLMafia
Jump to: navigation, search
needs(code_samples);

Function Syntax

buffer load_html(string page )

  • page is the page to visit

Returns the HTML from the visited page (not just what is displayed when visiting the page, but all markup) by performing a POST request. Note that for addresses inside of KoL, it is only necessary to supply the page name for page, and KoLmafia will populate the rest of the url. However, pages outside of KoL require the full url to be supplied for page.

The main difference between this function and visit_url() is that this function will only contact the server once each time the script is run; from then on, it will simply reload the previous html. Mainly useful for debugging, when you don't want to use extra server hits.

Also, this fuction will only work with URLs or files that end with .htm or .html.

See Also

Special

Note that this function returns an empty string if the page does not exist or if the request times out.