Interface WebFormManager.WillSendSubmitEventCallback

All Superinterfaces:

FunctionPointer

Enclosing class:

WebFormManager

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public static interface WebFormManager.WillSendSubmitEventCallback
extends FunctionPointer

Functional interface declaration of the WillSendSubmitEventCallback callback.

Since:

2.40

See Also:

• run(Value, Frame, Frame)

Method Summary

Modifier and Type	Method	Description
void	run(@Nullable Value form, @Nullable Frame sourceFrame, @Nullable Frame targetFrame)	This signal is emitted when the DOM submit event is about to be fired for form. JavaScript code may rely on the submit event to detect that the user has clicked on a submit button, and to possibly cancel the form submission before WebKitWebFormManager::will-submit-form signal is emitted.
default MemorySegment	toCallback(Arena arena)	Creates a native function pointer to the upcall(MemorySegment, MemorySegment, MemorySegment, MemorySegment) method.
default void	upcall(MemorySegment sourceWebFormManager, MemorySegment form, MemorySegment sourceFrame, MemorySegment targetFrame)	The upcall method is called from native code.

Method Details

run

void run(@Nullable Value form,
 @Nullable Frame sourceFrame,
 @Nullable Frame targetFrame)

This signal is emitted when the DOM submit event is about to be fired for form. JavaScript code may rely on the submit event to detect that the user has clicked on a submit button, and to possibly cancel the form submission before WebKitWebFormManager::will-submit-form signal is emitted. However, beware that, for historical reasons, the submit event is not emitted at all if the form submission is triggered by JavaScript. For these reasons, this signal may not be used to reliably detect whether a form will be submitted. Instead, use it to detect if a user has clicked on a form's submit button even if JavaScript later cancels the form submission, or to read the values of the form's fields even if JavaScript later clears certain fields before submitting. This may be needed, for example, to implement a robust browser password manager, as some misguided websites may use such techniques to attempt to thwart password managers.

Since:

2.40

upcall

default void upcall(MemorySegment sourceWebFormManager,
 MemorySegment form,
 MemorySegment sourceFrame,
 MemorySegment targetFrame)

The upcall method is called from native code. The parameters are marshaled and run(Value, Frame, Frame) is executed.

toCallback

default MemorySegment toCallback(Arena arena)

Creates a native function pointer to the upcall(MemorySegment, MemorySegment, MemorySegment, MemorySegment) method.

Specified by:

toCallback in interface FunctionPointer

Parameters:

arena - the arena in which the function pointer is allocated

Returns:

the native function pointer