[Home](./index.md) > [@friendlycaptcha/sdk](./sdk.md) > [WidgetHandle](./sdk.widgethandle.md) ## WidgetHandle class This provides an API stub that provides the end-user JS API for a widget. This class is only instantiated by the SDK - do not create a handle yourself. **Signature:** ```typescript export declare class WidgetHandle ``` ## Remarks The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `WidgetHandle` class. ## Properties

Property	Modifiers	Type	Description
[id](./sdk.widgethandle.id.md)	`readonly`	string	A random ID that uniquely identifies this widget in this session.
[isDestroyed](./sdk.widgethandle.isdestroyed.md)		boolean	When this is true the widget has been destroyed and can no longer be used.
[sitekey?](./sdk.widgethandle.sitekey.md)	`readonly`	string	_(Optional)_ The sitekey for this widget. It can not be changed after creation of the widget.
[startMode](./sdk.widgethandle.startmode.md)		[StartMode](./sdk.startmode.md)

## Methods

Method	Modifiers	Description
[addEventListener(type, listener, options)](./sdk.widgethandle.addeventlistener.md)		Shorthand for `this.getElement().addEventListener` (that is strictly typed in Typescript)
[destroy()](./sdk.widgethandle.destroy.md)		Destroy the widget. This removes the `element` that the widget was mounted to as well as the hidden `frc-captcha-response` form field.
[getElement()](./sdk.widgethandle.getelement.md)		The HTML element that contains the widget.
[getResponse()](./sdk.widgethandle.getresponse.md)		The current response of the widget. This is the value that should be sent to the server and is embedded in HTML forms.
[getState()](./sdk.widgethandle.getstate.md)		The current state of the widget.
[removeEventListener(type, listener, options)](./sdk.widgethandle.removeeventlistener.md)		Shorthand for `this.getElement().removeEventListener` (that is strictly typed in Typescript)
[reset(opts)](./sdk.widgethandle.reset.md)		Reset the widget, removing any progress. Optional argument: an object with the name of the trigger that caused the reset. You would usually keep this empty. This is the `trigger` field in the `frc:widget.reset` event, which defaults to `root`.
[start()](./sdk.widgethandle.start.md)		Trigger the widget to start a challenge. The widget will start a challenge solving in the background. \* In `interactive` mode, the user will need to click the widget to complete the process. \* In `noninteractive` mode, the widget will complete the process automatically.