0% found this document useful (0 votes)

109 views

Netsparker.: Click (El, Delay)

The document describes methods for automating form authentication in Netspaker scans. It contains methods for clicking elements, executing code in iframes, logging messages, filling login forms, and setting input values. The methods take HTML elements or CSS selectors as parameters and some allow optional delays in milliseconds.

Uploaded by

Valentine Wall

Available Formats

Download as PDF, TXT or read online on Scribd

0% found this document useful (0 votes)

109 views

Netsparker.: Click (El, Delay)

Uploaded by

Valentine Wall

Available Formats

Download as PDF, TXT or read online on Scribd

You are on page 1/ 6

netsparker.

auth
Contains form authentication helper methods.

Methods

click(el, delayopt)

Simulates a click for the speciﬁed el.

Parameters:

Name Type Attributes Description

el string | The element to click.

HTMLElement

delay number <optional> The number of milliseconds (thousandths of a second) that the click should be delayed by. Note
that all delays are timed from the beginning of the script execution and does not work in
sequence if you have several function calls with delay.

Example

// Click element by id
netsparker.auth.click('LoginButton');
// Click element by id after 2 seconds
netsparker.auth.click('LoginButton', 2000);
// Click element by DOM element reference
netsparker.auth.click(document.getElementsByTagName('BUTTON')[0]);
clickByQuery(query, delayopt)

Simulates a click for the element speciﬁed by the CSS query.

Parameters:

Name Type Attributes Description

query string The CSS query that locates the element.

delay number <optional> The number of milliseconds (thousandths of a second) that the click should be delayed by. Note that all
delays are timed from the beginning of the script execution and does not work in sequence if you have
several function calls with delay.

Example

// Click element by using a complex CSS query
netsparker.auth.clickByQuery('#loginForm > div:nth‐child(2) > button');
// Click element by id
netsparker.auth.clickByQuery('#LoginButton');
// Click element by id after 2 seconds
netsparker.auth.clickByQuery('#LoginButton', 2000);
executeInFrame(frameEl, code, delayopt)

Executes the supplied code in speciﬁed frame element.

Parameters:

Name Type Attributes Description

frameEl string | The frame element id or DOM reference to execute code.

HTMLElement

code string The code to execute.

delay number <optional> The number of milliseconds (thousandths of a second) that the code execution should be
delayed by. Note that all delays are timed from the beginning of the script execution and does
not work in sequence if you have several function calls with delay.

Example

// Clicks an element inside a frame
var frame = document.getElementsByTagName('IFRAME')[1];
netsparker.auth.executeInFrame(frame, 'netsparker.auth.click("LoginButton");');

log(message)

Logs a message.

Parameters:

Name Type Description

message string The message.

Example

// Log a simple message
netsparker.auth.log('Hello world!');
login(usernameopt, passwordopt, delayopt)

Tries to find a login form and fill the specified credentials.

Parameters:

Name Type Attributes Description

username string <optional> The username to ﬁll.

password string <optional> The password to ﬁll.

delay number <optional> The number of milliseconds (thousandths of a second) that the login should be delayed by. Note
that all delays are timed from the beginning of the script execution and does not work in sequence
if you have several function calls with delay.

Example

// Login using hard‐coded values
netsparker.auth.login('john.doe', 'p4ssw0rd');
// Login using hard‐coded values after 2 seconds
netsparker.auth.login('john.doe', 'p4ssw0rd', 2000);
// Login using implicit credentials (current persona)
netsparker.auth.login();
// Login using implicit credentials (current persona) after 2 seconds
netsparker.auth.login(2000);
setInputValue(el, value, delayopt)

Sets the value of speciﬁed el.

Parameters:

Name Type Attributes Description

el string | The element to click.

HTMLElement

value string The value to set.

delay number <optional> The number of milliseconds (thousandths of a second) that this set value operation should be
delayed by. Note that all delays are timed from the beginning of the script execution and does
not work in sequence if you have several function calls with delay.

Example

// Set value by id
netsparker.auth.setInputValue('Username', 'john.doe');
// Set value after 2 seconds
netsparker.auth.setInputValue('Username', 'john.doe', 2000);
// Set value by DOM element reference
netsparker.auth.setInputValue(document.forms[0].elements[0], 'john.doe');
setValueByQuery(query, value, delayopt)

Finds input element using the CSS query and sets its value.

Parameters:

Name Type Attributes Description

query string The CSS query that locates the element.

value string The value to set.

delay number <optional> The number of milliseconds (thousandths of a second) that this set value operation should be delayed
by. Note that all delays are timed from the beginning of the script execution and does not work in
sequence if you have several function calls with delay.

Example

// Query complex paths
netsparker.auth.setValueByQuery('#loginForm > div:nth‐child(2) > input', 'john.doe');
// Query by id
netsparker.auth.setValueByQuery('#Username', 'john.doe');
// Set value after 2 seconds
netsparker.auth.setValueByQuery('#Username', 'john.doe', 2000);