aboutsummaryrefslogtreecommitdiffhomepage
path: root/README
diff options
context:
space:
mode:
authorGravatar Brendan Taylor <whateley@gmail.com>2011-11-23 18:40:17 -0700
committerGravatar Brendan Taylor <whateley@gmail.com>2011-11-23 18:40:17 -0700
commitfd7cbacdf11d3c54f0e1ce72b43bdd2b9b2387f9 (patch)
treefafed60ab1b9037207fe48d5fa2f0042fd9a0cd7 /README
parent31a000f55d13178fa440f852074bcb3593cdf8fa (diff)
parent38fd1f02bbdc5edda7daf8210a0d2b241bc9b412 (diff)
Merge commit '38fd1f02bbdc5edda7'
Diffstat (limited to 'README')
-rw-r--r--README12
1 files changed, 10 insertions, 2 deletions
diff --git a/README b/README
index 2ef6c8d..2cdc0cd 100644
--- a/README
+++ b/README
@@ -312,6 +312,9 @@ file).
- `data`: The cookie data. Only included for "PUT" requests.
* `scheme_handler`: handler to execute for each URI navigated to - the
navigation request will be ignored if handler prints "USED\n"
+* `request_handler`: Executed whenever any request is made. The handler can
+ print a URI to redirect the request (or `about:blank` to effectively cancel it).
+ If the handler does nothing, the request will continue unchanged.
* `download_handler`: executed when a download is started. the handler script
should print a path that the download should be saved to, or print nothing
to cancel the download.
@@ -506,8 +509,9 @@ access to the following environment variables:
* `$UZBL_URI`: The URI of the current page.
* `$UZBL_TITLE`: The current page title.
-Handler scripts (`download_handler`, `cookie_handler`, `scheme_handler` and
-`authentication_handler`) are called with special arguments:
+Handler scripts (`download_handler`, `cookie_handler`, `scheme_handler`,
+`request_handler`, and `authentication_handler`) are called with special
+arguments:
* download handler
@@ -536,6 +540,10 @@ Handler scripts (`download_handler`, `cookie_handler`, `scheme_handler` and
- `$1 URI` of the page to be navigated to
+* request handler
+
+ - `$1 URI` of the resource which is being requested
+
* authentication handler:
- `$1`: authentication zone unique identifier