Struct fantoccini::Form

pub struct Form { /* fields omitted */ }

An HTML form on the current page.

Methods

impl Form

pub fn set(
    &mut self,
    locator: Locator,
    value: &str
) -> impl Future<Item = Self, Error = CmdError>

Find a form input using the given locator and set its value to value.

pub fn set_by_name<'s>(
    &mut self,
    field: &str,
    value: &str
) -> impl Future<Item = Self, Error = CmdError>

Find a form input with the given name and set its value to value.

pub fn submit(self) -> impl Future<Item = Client, Error = CmdError>

Submit this form using the first available submit button.

false is returned if no submit button was not found.

pub fn submit_with(
    self,
    button: Locator
) -> impl Future<Item = Client, Error = CmdError>

Submit this form using the button matched by the given selector.

false is returned if a matching button was not found.

pub fn submit_using(
    self,
    button_label: &str
) -> impl Future<Item = Client, Error = CmdError>

Submit this form using the form submit button with the given label (case-insensitive).

false is returned if a matching button was not found.

pub fn submit_direct(self) -> impl Future<Item = Client, Error = CmdError>

Submit this form directly, without clicking any buttons.

This can be useful to bypass forms that perform various magic when the submit button is clicked, or that hijack click events altogether (yes, I'm looking at you online advertisement code).

Note that since no button is actually clicked, the name=value pair for the submit button will not be submitted. This can be circumvented by using submit_sneaky instead.

pub fn submit_sneaky(
    self,
    field: &str,
    value: &str
) -> impl Future<Item = Client, Error = CmdError>

Submit this form directly, without clicking any buttons, and with an extra field.

Like submit_direct, this method will submit this form without clicking a submit button. However, it will also inject a hidden input element on the page that carries the given field=value mapping. This allows you to emulate the form data as it would have been if the submit button was indeed clicked.

pub fn client(self) -> Client

Get back the Client hosting this Form.

Trait Implementations

impl Clone for Form

fn clone(&self) -> Form

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.