Struct fantoccini::Form

pub struct Form { /* fields omitted */ }

An HTML form on the current page.

Methods

impl Form

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

Set the value of the given field in this form.

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> + 'static

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> + 'static

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> + 'static

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> + 'static

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.

Trait Implementations