227 lines
7.4 KiB
Plaintext
227 lines
7.4 KiB
Plaintext
--------------------------------------------------------------------------------
|
|
Usage Instructions for Monkey NetSurf 13 March 2011
|
|
--------------------------------------------------------------------------------
|
|
|
|
This document provides usage instructions for the Monkey version of
|
|
NetSurf.
|
|
|
|
Monkey NetSurf has been tested on Ubuntu.
|
|
|
|
Overview
|
|
========
|
|
|
|
What it is
|
|
----------
|
|
|
|
The NetSurf Monkey front end is a developer debug tool used to
|
|
test how the core interacts with the user interface. It allows
|
|
the developers to profile NetSurf and to interact with the core
|
|
directly as though the developer were a front end.
|
|
|
|
What it is not
|
|
--------------
|
|
|
|
Monkey is not a tool for building web-crawling robots or indeed
|
|
anything other than a debug tool for the NetSurf developers.
|
|
|
|
How to interact with nsmonkey
|
|
-----------------------------
|
|
|
|
In brief, monkey will produce tagged output on stdout and expect
|
|
commands on stdin. Windows are numbered and for the most part
|
|
tokens are space separated. In some cases (e.g. title or status)
|
|
the final element on the output line is a string which might have
|
|
spaces embedded within it. As such, output from nsmonkey should be
|
|
parsed a token at a time, so that when such a string is encountered,
|
|
the parser can stop splitting and return the rest.
|
|
|
|
Top level tags for nsmonkey
|
|
---------------------------
|
|
|
|
GENERIC
|
|
|
|
WARN, ERROR, DIE
|
|
|
|
WINDOW
|
|
|
|
DOWNLOAD_WINDOW
|
|
|
|
SSLCERT
|
|
|
|
401LOGIN
|
|
|
|
In the below, %something% indicates a substitution made by Monkey.
|
|
|
|
%url% will be a URL
|
|
%id% will be an opaque ID
|
|
%n% will be a number
|
|
%bool% will be TRUE or FALSE
|
|
%str% is a string and will only ever be at the end of an output line.
|
|
|
|
Warnings, errors etc
|
|
--------------------
|
|
|
|
Warnings (tagged WARN) come from the NetSurf core.
|
|
Errors (tagged ERROR) tend to come from Monkey's parsers
|
|
Death (tagged DIE) comes from the core and kills Monkey dead.
|
|
|
|
Generic messages
|
|
----------------
|
|
|
|
GENERIC STARTED
|
|
Monkey has started and is ready for commands
|
|
GENERIC CLOSING_DOWN
|
|
Monkey has been told to shut down and is doing so
|
|
GENERIC FINISHED
|
|
Monkey has finished and will now exit
|
|
GENERIC LAUNCH URL %url%
|
|
The core asked monkey to launch the given URL
|
|
GENERIC THUMBNAIL URL %url%
|
|
The core asked monkey to thumbnail a content without
|
|
a window.
|
|
GENERIC POLL BLOCKING
|
|
Monkey reached a point where it could sleep waiting for
|
|
commands or scheduled timeouts. No fetches nor redraws
|
|
were pending.
|
|
|
|
Window messages
|
|
---------------
|
|
|
|
WINDOW NEW WIN %id% FOR %id% CLONE %id% NEWTAB %bool%
|
|
The core asked Monkey to open a new window. The IDs for 'FOR' and
|
|
'CLONE' are core window IDs, the WIN id is a Monkey window ID.
|
|
|
|
WINDOW SIZE WIN %id% WIDTH %num% HEIGHT %num%
|
|
The window specified has been set to the shown width and height.
|
|
|
|
WINDOW DESTROY WIN %id%
|
|
The core has instructed Monkey to destroy the named window.
|
|
|
|
WINDOW TITLE WIN %id% STR %str%
|
|
The core supplied a titlebar title for the given window.
|
|
|
|
WINDOW REDRAW WIN %id%
|
|
The core asked that Monkey redraw the given window.
|
|
|
|
WINDOW GET_DIMENSIONS WIN %id% WIDTH %num% HEIGHT %num%
|
|
The core asked Monkey what the dimensions of the window are.
|
|
Monkey has to respond immediately and returned the supplied width
|
|
and height values to the core.
|
|
|
|
WINDOW NEW_CONTENT WIN %id%
|
|
The core has informed Monkey that the named window has a new
|
|
content object.
|
|
|
|
WINDOW NEW_ICON WIN %id%
|
|
The core has informed Monkey that the named window hsa a new
|
|
icon (favicon) available.
|
|
|
|
WINDOW START_THROBBER WIN %id%
|
|
The core asked Monkey to start the throbber for the named
|
|
window. This indicates to the user that the window is busy.
|
|
|
|
WINDOW STOP_THROBBER WIN %id%
|
|
The core asked Monkey to stop the throbber for the named
|
|
window. This indicates to the user that the window is finished.
|
|
|
|
WINDOW SET_SCROLL WIN %id% X %num% Y %num%
|
|
The core asked Monkey to set the named window's scroll offsets
|
|
to the given X and Y position.
|
|
|
|
WINDOW UPDATE_BOX WIN %id% X %num% Y %num% WIDTH %num% HEIGHT %num%
|
|
The core asked Monkey to redraw the given portion of the content
|
|
display. Note these coordinates refer to the content, not the
|
|
viewport which Monkey is simulating.
|
|
|
|
WINDOW UPDATE_EXTENT WIN %id% WIDTH %num% HEIGHT %num%
|
|
The core has told us that the content in the given window has a
|
|
total width and height as shown. This allows us (along with the
|
|
window's width and height) to know the scroll limits.
|
|
|
|
WINDOW SET_STATUS WIN %id% STR %str%
|
|
The core has told us that the given window needs its status bar
|
|
updating with the given message.
|
|
|
|
WINDOW SET_POINTER WIN %id% POINTER %id%
|
|
The core has told us to update the mouse pointer for the given
|
|
window to the given pointer ID.
|
|
|
|
WINDOW SET_SCALE WIN %id% SCALE %num%
|
|
The core has asked us to scale the given window by the given scale
|
|
factor.
|
|
|
|
WINDOW SET_URL WIN %id% URL %url%
|
|
The core has informed us that the given window's URL bar needs
|
|
updating to the given url.
|
|
|
|
WINDOW GET_SCROLL WIN %id% X %num% Y %num%
|
|
The core asked Monkey for the scroll offsets. Monkey returned the
|
|
numbers shown for the window named.
|
|
|
|
WINDOW SCROLL_START WIN %id%
|
|
The core asked Monkey to scroll the named window to the top/left.
|
|
|
|
WINDOW POSITION_FRAME WIN %id% X0 %num% Y0 %num% X1 %num% Y1 %num%
|
|
The core asked Monkey to position the named window as a frame at
|
|
the given coordinates of its parent.
|
|
|
|
WINDOW SCROLL_VISIBLE WIN %id% X0 %num% Y0 %num% X1 %num% Y1 %num%
|
|
The core asked Monkey to scroll the named window until the
|
|
indicated box is visible.
|
|
|
|
WINDOW PLACE_CARET WIN %id% X %num% Y %num% HEIGHT %num%
|
|
The core asked Monkey to render a caret in the named window at the
|
|
indicated position with the indicated height.
|
|
|
|
WINDOW REMOVE_CARET WIN %id%
|
|
The core asked Monkey to remove any caret in the named window.
|
|
|
|
WINDOW SCROLL_START WIN %id% X0 %num% Y0 %num% X1 %num% Y1 %num%
|
|
The core asked Monkey to scroll the named window to the start of
|
|
the given box.
|
|
|
|
WINDOW SELECT_MENU WIN %id%
|
|
The core asked Monkey to produce a selection menu for the named
|
|
window.
|
|
|
|
WINDOW SAVE_LINK WIN %id% URL %url% TITLE %str%
|
|
The core asked Monkey to save a link from the given window with
|
|
the given URL and anchor title.
|
|
|
|
WINDOW THUMBNAIL WIN %id% URL %url%
|
|
The core asked Monkey to render a thumbnail for the given window
|
|
which is currently at the given URL.
|
|
|
|
Download window messages
|
|
------------------------
|
|
|
|
DOWNLOAD_WINDOW CREATE DWIN %id% WIN %id%
|
|
The core asked Monkey to create a download window owned by the
|
|
given browser window.
|
|
|
|
DOWNLOAD_WINDOW DATA DWIN %id% SIZE %num% DATA %str%
|
|
The core asked Monkey to update the named download window with
|
|
the given byte size and data string.
|
|
|
|
DOWNLOAD_WINDOW ERROR DWIN %id% ERROR %str%
|
|
The core asked Monkey to update the named download window with
|
|
the given error message.
|
|
|
|
DOWNLOAD_WINDOW DONE DWIN %id%
|
|
The core asked Monkey to destroy the named download window.
|
|
|
|
SSL Certificate messages
|
|
------------------------
|
|
|
|
SSLCERT VERIFY CERT %id% URL %url%
|
|
The core asked Monkey to say whether or not a given SSL
|
|
certificate is OK.
|
|
|
|
401 Login messages
|
|
------------------
|
|
|
|
401LOGIN OPEN M4 %id% URL %url% REALM %str%
|
|
The core asked Monkey to ask for identification for the named
|
|
realm at the given URL.
|
|
|