akasha.speech

Class SpeechRecognition

java.lang.Object

akasha.core.JsObject

akasha.EventTarget

akasha.speech.SpeechRecognition

@Generated(value="org.realityforge.webtack")
 @JsType(isNative=true,
        namespace="<global>",
        name="Object")
public class SpeechRecognition
extends EventTarget

The SpeechRecognition interface of the Web Speech API is the controller interface for the recognition service; this also handles the SpeechRecognitionEvent sent from the recognition service.

See Also:

SpeechRecognition - MDN, # speechreco-section

Field Summary

Fields

Modifier and Type	Field and Description
boolean	continuous The continuous property of the SpeechRecognition interface controls whether continuous results are returned for each recognition, or only a single result.
@JsNonNull SpeechGrammarList	grammars The grammars property of the SpeechRecognition interface returns and sets a collection of SpeechGrammar objects that represent the grammars that will be understood by the current SpeechRecognition.
boolean	interimResults The interimResults property of the SpeechRecognition interface controls whether interim results should be returned (true) or not (false.) Interim results are results that are not yet final (e.g.
@JsNonNull java.lang.String	lang The lang property of the SpeechRecognition interface returns and sets the language of the current SpeechRecognition.
int	maxAlternatives The maxAlternatives property of the SpeechRecognition interface sets the maximum number of SpeechRecognitionAlternatives provided per SpeechRecognitionResult.
@JsNullable EventHandler	onaudioend The onaudioend property of the SpeechRecognition interface represents an event handler that will run when the user agent has finished capturing audio (when the audioend event fires.)
@JsNullable EventHandler	onaudiostart The onaudiostart property of the SpeechRecognition interface represents an event handler that will run when the user agent has started to capture audio (when the audiostart event fires.)
@JsNullable EventHandler	onend The onend property of the SpeechRecognition interface represents an event handler that will run when the speech recognition service has disconnected (when the end event fires.)
@JsNullable SpeechRecognitionErrorEventHandler	onerror The onerror property of the SpeechRecognition interface represents an event handler that will run when a speech recognition error occurs (when the error event fires.)
@JsNullable SpeechRecognitionEventHandler	onnomatch The onnomatch property of the SpeechRecognition interface represents an event handler that will run when the speech recognition service returns a final result with no significant recognition (when the nomatch event fires.)
@JsNullable SpeechRecognitionEventHandler	onresult The onresult property of the SpeechRecognition interface represents an event handler that will run when the speech recognition service returns a result — a word or phrase has been positively recognized and this has been communicated back to the app (when the result event fires.)
@JsNullable EventHandler	onsoundend The onsoundend property of the SpeechRecognition interface represents an event handler that will run when any sound — recognisable speech or not — has stopped being detected (when the soundend event fires.)
@JsNullable EventHandler	onsoundstart The onsoundstart property of the SpeechRecognition interface represents an event handler that will run when any sound — recognisable speech or not — has been detected (when the soundstart event fires.)
@JsNullable EventHandler	onspeechend The onspeechend property of the SpeechRecognition interface represents an event handler that will run when speech recognised by the speech recognition service has stopped being detected (when the speechend event fires.)
@JsNullable EventHandler	onspeechstart The onspeechstart property of the SpeechRecognition interface represents an event handler that will run when sound recognised by the speech recognition service as speech has been detected (when the speechstart event fires.)
@JsNullable EventHandler	onstart The onstart property of the SpeechRecognition interface represents an event handler that will run when the speech recognition service has begun listening to incoming audio with intent to recognize grammars associated with the current SpeechRecognition (when the start event fires.)

Constructor Summary

Constructors

Constructor and Description
SpeechRecognition() The SpeechRecognition() constructor creates a new SpeechRecognition object instance.

Method Summary

Modifier and Type	Method and Description
void	abort() The abort() method of the Web Speech API stops the speech recognition service from listening to incoming audio, and doesn't attempt to return a SpeechRecognitionResult.
void	addAudioendListener(EventListener callback)
void	addAudioendListener(EventListener callback, AddEventListenerOptions options)
void	addAudioendListener(EventListener callback, boolean useCapture)
void	addAudiostartListener(EventListener callback)
void	addAudiostartListener(EventListener callback, AddEventListenerOptions options)
void	addAudiostartListener(EventListener callback, boolean useCapture)
void	addEndListener(EventListener callback)
void	addEndListener(EventListener callback, AddEventListenerOptions options)
void	addEndListener(EventListener callback, boolean useCapture)
void	addErrorListener(SpeechRecognitionErrorEventListener callback)
void	addErrorListener(SpeechRecognitionErrorEventListener callback, AddEventListenerOptions options)
void	addErrorListener(SpeechRecognitionErrorEventListener callback, boolean useCapture)
void	addNomatchListener(SpeechRecognitionEventListener callback)
void	addNomatchListener(SpeechRecognitionEventListener callback, AddEventListenerOptions options)
void	addNomatchListener(SpeechRecognitionEventListener callback, boolean useCapture)
void	addResultListener(SpeechRecognitionEventListener callback)
void	addResultListener(SpeechRecognitionEventListener callback, AddEventListenerOptions options)
void	addResultListener(SpeechRecognitionEventListener callback, boolean useCapture)
void	addSoundendListener(EventListener callback)
void	addSoundendListener(EventListener callback, AddEventListenerOptions options)
void	addSoundendListener(EventListener callback, boolean useCapture)
void	addSoundstartListener(EventListener callback)
void	addSoundstartListener(EventListener callback, AddEventListenerOptions options)
void	addSoundstartListener(EventListener callback, boolean useCapture)
void	addSpeechendListener(EventListener callback)
void	addSpeechendListener(EventListener callback, AddEventListenerOptions options)
void	addSpeechendListener(EventListener callback, boolean useCapture)
void	addSpeechstartListener(EventListener callback)
void	addSpeechstartListener(EventListener callback, AddEventListenerOptions options)
void	addSpeechstartListener(EventListener callback, boolean useCapture)
void	addStartListener(EventListener callback)
void	addStartListener(EventListener callback, AddEventListenerOptions options)
void	addStartListener(EventListener callback, boolean useCapture)
void	removeAudioendListener(EventListener callback)
void	removeAudioendListener(EventListener callback, boolean useCapture)
void	removeAudioendListener(EventListener callback, EventListenerOptions options)
void	removeAudiostartListener(EventListener callback)
void	removeAudiostartListener(EventListener callback, boolean useCapture)
void	removeAudiostartListener(EventListener callback, EventListenerOptions options)
void	removeEndListener(EventListener callback)
void	removeEndListener(EventListener callback, boolean useCapture)
void	removeEndListener(EventListener callback, EventListenerOptions options)
void	removeErrorListener(SpeechRecognitionErrorEventListener callback)
void	removeErrorListener(SpeechRecognitionErrorEventListener callback, boolean useCapture)
void	removeErrorListener(SpeechRecognitionErrorEventListener callback, EventListenerOptions options)
void	removeNomatchListener(SpeechRecognitionEventListener callback)
void	removeNomatchListener(SpeechRecognitionEventListener callback, boolean useCapture)
void	removeNomatchListener(SpeechRecognitionEventListener callback, EventListenerOptions options)
void	removeResultListener(SpeechRecognitionEventListener callback)
void	removeResultListener(SpeechRecognitionEventListener callback, boolean useCapture)
void	removeResultListener(SpeechRecognitionEventListener callback, EventListenerOptions options)
void	removeSoundendListener(EventListener callback)
void	removeSoundendListener(EventListener callback, boolean useCapture)
void	removeSoundendListener(EventListener callback, EventListenerOptions options)
void	removeSoundstartListener(EventListener callback)
void	removeSoundstartListener(EventListener callback, boolean useCapture)
void	removeSoundstartListener(EventListener callback, EventListenerOptions options)
void	removeSpeechendListener(EventListener callback)
void	removeSpeechendListener(EventListener callback, boolean useCapture)
void	removeSpeechendListener(EventListener callback, EventListenerOptions options)
void	removeSpeechstartListener(EventListener callback)
void	removeSpeechstartListener(EventListener callback, boolean useCapture)
void	removeSpeechstartListener(EventListener callback, EventListenerOptions options)
void	removeStartListener(EventListener callback)
void	removeStartListener(EventListener callback, boolean useCapture)
void	removeStartListener(EventListener callback, EventListenerOptions options)
void	start() The start() method of the Web Speech API starts the speech recognition service listening to incoming audio with intent to recognize grammars associated with the current SpeechRecognition.
void	stop() The stop() method of the Web Speech API stops the speech recognition service from listening to incoming audio, and attempts to return a SpeechRecognitionResult using the audio captured so far.

Methods inherited from class akasha.EventTarget

addEventListener, addEventListener, addEventListener, dispatchEvent, removeEventListener, removeEventListener, removeEventListener

Methods inherited from class akasha.core.JsObject

assign, create, create, defineProperties, defineProperty, defineProperty, entries, freeze, fromEntries, getOwnPropertyDescriptor, getOwnPropertyDescriptor, getOwnPropertyDescriptors, getOwnPropertyNames, getOwnPropertySymbols, getPrototypeOf, hasOwnProperty, hasOwnProperty, is, isExtensible, isFrozen, isPrototypeOf, isSealed, keys, preventExtensions, propertyIsEnumerable, seal, setPrototypeOf, toString_, valueOf_, values

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

continuous

public boolean continuous

The continuous property of the SpeechRecognition interface controls whether continuous results are returned for each recognition, or only a single result.

See Also:

SpeechRecognition.continuous - MDN, continuous - Web Speech API

grammars

public @JsNonNull SpeechGrammarList grammars

The grammars property of the SpeechRecognition interface returns and sets a collection of SpeechGrammar objects that represent the grammars that will be understood by the current SpeechRecognition.

See Also:

SpeechRecognition.grammars - MDN, grammars - Web Speech API

interimResults

public boolean interimResults

The interimResults property of the SpeechRecognition interface controls whether interim results should be returned (true) or not (false.) Interim results are results that are not yet final (e.g. the SpeechRecognitionResult.isFinal property is false.)

See Also:

SpeechRecognition.interimResults - MDN, interimResults - Web Speech API

lang

public @JsNonNull java.lang.String lang

The lang property of the SpeechRecognition interface returns and sets the language of the current SpeechRecognition. If not specified, this defaults to the HTML lang attribute value, or the user agent's language setting if that isn't set either.

See Also:

SpeechRecognition.lang - MDN, lang - Web Speech API

maxAlternatives

public int maxAlternatives

The maxAlternatives property of the SpeechRecognition interface sets the maximum number of SpeechRecognitionAlternatives provided per SpeechRecognitionResult.

See Also:

SpeechRecognition.maxAlternatives - MDN, maxAlternatives - Web Speech API

onaudioend

public @JsNullable EventHandler onaudioend

The onaudioend property of the SpeechRecognition interface represents an event handler that will run when the user agent has finished capturing audio (when the audioend event fires.)

See Also:

SpeechRecognition.onaudioend - MDN, onaudioend - Web Speech API

onaudiostart

public @JsNullable EventHandler onaudiostart

The onaudiostart property of the SpeechRecognition interface represents an event handler that will run when the user agent has started to capture audio (when the audiostart event fires.)

See Also:

SpeechRecognition.onaudiostart - MDN, onaudiostart - Web Speech API

onend

public @JsNullable EventHandler onend

The onend property of the SpeechRecognition interface represents an event handler that will run when the speech recognition service has disconnected (when the end event fires.)

See Also:

SpeechRecognition.onend - MDN, onend - Web Speech API

onerror

public @JsNullable SpeechRecognitionErrorEventHandler onerror

The onerror property of the SpeechRecognition interface represents an event handler that will run when a speech recognition error occurs (when the error event fires.)

See Also:

SpeechRecognition.onerror - MDN, onerror - Web Speech API

onnomatch

public @JsNullable SpeechRecognitionEventHandler onnomatch

The onnomatch property of the SpeechRecognition interface represents an event handler that will run when the speech recognition service returns a final result with no significant recognition (when the nomatch event fires.)

See Also:

SpeechRecognition.onnomatch - MDN, onnomatch - Web Speech API

onresult

public @JsNullable SpeechRecognitionEventHandler onresult

The onresult property of the SpeechRecognition interface represents an event handler that will run when the speech recognition service returns a result — a word or phrase has been positively recognized and this has been communicated back to the app (when the result event fires.)

See Also:

SpeechRecognition.onresult - MDN, onresult - Web Speech API

onsoundend

public @JsNullable EventHandler onsoundend

The onsoundend property of the SpeechRecognition interface represents an event handler that will run when any sound — recognisable speech or not — has stopped being detected (when the soundend event fires.)

See Also:

SpeechRecognition.onsoundend - MDN, onsoundend - Web Speech API

onsoundstart

public @JsNullable EventHandler onsoundstart

The onsoundstart property of the SpeechRecognition interface represents an event handler that will run when any sound — recognisable speech or not — has been detected (when the soundstart event fires.)

See Also:

SpeechRecognition.onsoundstart - MDN, onsoundstart - Web Speech API

onspeechend

public @JsNullable EventHandler onspeechend

The onspeechend property of the SpeechRecognition interface represents an event handler that will run when speech recognised by the speech recognition service has stopped being detected (when the speechend event fires.)

See Also:

SpeechRecognition.onspeechend - MDN, onspeechend - Web Speech API

onspeechstart

public @JsNullable EventHandler onspeechstart

The onspeechstart property of the SpeechRecognition interface represents an event handler that will run when sound recognised by the speech recognition service as speech has been detected (when the speechstart event fires.)

See Also:

SpeechRecognition.onspeechstart - MDN, onspeechstart - Web Speech API

onstart

public @JsNullable EventHandler onstart

The onstart property of the SpeechRecognition interface represents an event handler that will run when the speech recognition service has begun listening to incoming audio with intent to recognize grammars associated with the current SpeechRecognition (when the start event fires.)

See Also:

SpeechRecognition.onstart - MDN, onstart - Web Speech API

Constructor Detail

SpeechRecognition

public SpeechRecognition()

The SpeechRecognition() constructor creates a new SpeechRecognition object instance.

See Also:

SpeechRecognition.SpeechRecognition - MDN, SpeechRecognition() - Web Speech API

Method Detail

abort

public void abort()

The abort() method of the Web Speech API stops the speech recognition service from listening to incoming audio, and doesn't attempt to return a SpeechRecognitionResult.

See Also:

SpeechRecognition.abort - MDN, abort() - Web Speech API

start

public void start()

The start() method of the Web Speech API starts the speech recognition service listening to incoming audio with intent to recognize grammars associated with the current SpeechRecognition.

See Also:

SpeechRecognition.start - MDN, start() - Web Speech API

stop

public void stop()

The stop() method of the Web Speech API stops the speech recognition service from listening to incoming audio, and attempts to return a SpeechRecognitionResult using the audio captured so far.

See Also:

SpeechRecognition.stop - MDN, stop() - Web Speech API

addErrorListener

@JsOverlay
public final void addErrorListener(@Nonnull
                                              SpeechRecognitionErrorEventListener callback,
                                              @Nonnull
                                              AddEventListenerOptions options)

addErrorListener

@JsOverlay
public final void addErrorListener(@Nonnull
                                              SpeechRecognitionErrorEventListener callback,
                                              boolean useCapture)

addErrorListener

@JsOverlay
public final void addErrorListener(@Nonnull
                                              SpeechRecognitionErrorEventListener callback)

removeErrorListener

@JsOverlay
public final void removeErrorListener(@Nonnull
                                                 SpeechRecognitionErrorEventListener callback,
                                                 @Nonnull
                                                 EventListenerOptions options)

removeErrorListener

@JsOverlay
public final void removeErrorListener(@Nonnull
                                                 SpeechRecognitionErrorEventListener callback,
                                                 boolean useCapture)

removeErrorListener

@JsOverlay
public final void removeErrorListener(@Nonnull
                                                 SpeechRecognitionErrorEventListener callback)

addNomatchListener

@JsOverlay
public final void addNomatchListener(@Nonnull
                                                SpeechRecognitionEventListener callback,
                                                @Nonnull
                                                AddEventListenerOptions options)

addNomatchListener

@JsOverlay
public final void addNomatchListener(@Nonnull
                                                SpeechRecognitionEventListener callback,
                                                boolean useCapture)

addNomatchListener

@JsOverlay
public final void addNomatchListener(@Nonnull
                                                SpeechRecognitionEventListener callback)

removeNomatchListener

@JsOverlay
public final void removeNomatchListener(@Nonnull
                                                   SpeechRecognitionEventListener callback,
                                                   @Nonnull
                                                   EventListenerOptions options)

removeNomatchListener

@JsOverlay
public final void removeNomatchListener(@Nonnull
                                                   SpeechRecognitionEventListener callback,
                                                   boolean useCapture)

removeNomatchListener

@JsOverlay
public final void removeNomatchListener(@Nonnull
                                                   SpeechRecognitionEventListener callback)

addResultListener

@JsOverlay
public final void addResultListener(@Nonnull
                                               SpeechRecognitionEventListener callback,
                                               @Nonnull
                                               AddEventListenerOptions options)

addResultListener

@JsOverlay
public final void addResultListener(@Nonnull
                                               SpeechRecognitionEventListener callback,
                                               boolean useCapture)

addResultListener

@JsOverlay
public final void addResultListener(@Nonnull
                                               SpeechRecognitionEventListener callback)

removeResultListener

@JsOverlay
public final void removeResultListener(@Nonnull
                                                  SpeechRecognitionEventListener callback,
                                                  @Nonnull
                                                  EventListenerOptions options)

removeResultListener

@JsOverlay
public final void removeResultListener(@Nonnull
                                                  SpeechRecognitionEventListener callback,
                                                  boolean useCapture)

removeResultListener

@JsOverlay
public final void removeResultListener(@Nonnull
                                                  SpeechRecognitionEventListener callback)

addAudioendListener

@JsOverlay
public final void addAudioendListener(@Nonnull
                                                 EventListener callback,
                                                 @Nonnull
                                                 AddEventListenerOptions options)

addAudioendListener

@JsOverlay
public final void addAudioendListener(@Nonnull
                                                 EventListener callback,
                                                 boolean useCapture)

addAudioendListener

@JsOverlay
public final void addAudioendListener(@Nonnull
                                                 EventListener callback)

removeAudioendListener

@JsOverlay
public final void removeAudioendListener(@Nonnull
                                                    EventListener callback,
                                                    @Nonnull
                                                    EventListenerOptions options)

removeAudioendListener

@JsOverlay
public final void removeAudioendListener(@Nonnull
                                                    EventListener callback,
                                                    boolean useCapture)

removeAudioendListener

@JsOverlay
public final void removeAudioendListener(@Nonnull
                                                    EventListener callback)

addAudiostartListener

@JsOverlay
public final void addAudiostartListener(@Nonnull
                                                   EventListener callback,
                                                   @Nonnull
                                                   AddEventListenerOptions options)

addAudiostartListener

@JsOverlay
public final void addAudiostartListener(@Nonnull
                                                   EventListener callback,
                                                   boolean useCapture)

addAudiostartListener

@JsOverlay
public final void addAudiostartListener(@Nonnull
                                                   EventListener callback)

removeAudiostartListener

@JsOverlay
public final void removeAudiostartListener(@Nonnull
                                                      EventListener callback,
                                                      @Nonnull
                                                      EventListenerOptions options)

removeAudiostartListener

@JsOverlay
public final void removeAudiostartListener(@Nonnull
                                                      EventListener callback,
                                                      boolean useCapture)

removeAudiostartListener

@JsOverlay
public final void removeAudiostartListener(@Nonnull
                                                      EventListener callback)

addEndListener

@JsOverlay
public final void addEndListener(@Nonnull
                                            EventListener callback,
                                            @Nonnull
                                            AddEventListenerOptions options)

addEndListener

@JsOverlay
public final void addEndListener(@Nonnull
                                            EventListener callback,
                                            boolean useCapture)

addEndListener

@JsOverlay
public final void addEndListener(@Nonnull
                                            EventListener callback)

removeEndListener

@JsOverlay
public final void removeEndListener(@Nonnull
                                               EventListener callback,
                                               @Nonnull
                                               EventListenerOptions options)

removeEndListener

@JsOverlay
public final void removeEndListener(@Nonnull
                                               EventListener callback,
                                               boolean useCapture)

removeEndListener

@JsOverlay
public final void removeEndListener(@Nonnull
                                               EventListener callback)

addSoundendListener

@JsOverlay
public final void addSoundendListener(@Nonnull
                                                 EventListener callback,
                                                 @Nonnull
                                                 AddEventListenerOptions options)

addSoundendListener

@JsOverlay
public final void addSoundendListener(@Nonnull
                                                 EventListener callback,
                                                 boolean useCapture)

addSoundendListener

@JsOverlay
public final void addSoundendListener(@Nonnull
                                                 EventListener callback)

removeSoundendListener

@JsOverlay
public final void removeSoundendListener(@Nonnull
                                                    EventListener callback,
                                                    @Nonnull
                                                    EventListenerOptions options)

removeSoundendListener

@JsOverlay
public final void removeSoundendListener(@Nonnull
                                                    EventListener callback,
                                                    boolean useCapture)

removeSoundendListener

@JsOverlay
public final void removeSoundendListener(@Nonnull
                                                    EventListener callback)

addSoundstartListener

@JsOverlay
public final void addSoundstartListener(@Nonnull
                                                   EventListener callback,
                                                   @Nonnull
                                                   AddEventListenerOptions options)

addSoundstartListener

@JsOverlay
public final void addSoundstartListener(@Nonnull
                                                   EventListener callback,
                                                   boolean useCapture)

addSoundstartListener

@JsOverlay
public final void addSoundstartListener(@Nonnull
                                                   EventListener callback)

removeSoundstartListener

@JsOverlay
public final void removeSoundstartListener(@Nonnull
                                                      EventListener callback,
                                                      @Nonnull
                                                      EventListenerOptions options)

removeSoundstartListener

@JsOverlay
public final void removeSoundstartListener(@Nonnull
                                                      EventListener callback,
                                                      boolean useCapture)

removeSoundstartListener

@JsOverlay
public final void removeSoundstartListener(@Nonnull
                                                      EventListener callback)

addSpeechendListener

@JsOverlay
public final void addSpeechendListener(@Nonnull
                                                  EventListener callback,
                                                  @Nonnull
                                                  AddEventListenerOptions options)

addSpeechendListener

@JsOverlay
public final void addSpeechendListener(@Nonnull
                                                  EventListener callback,
                                                  boolean useCapture)

addSpeechendListener

@JsOverlay
public final void addSpeechendListener(@Nonnull
                                                  EventListener callback)

removeSpeechendListener

@JsOverlay
public final void removeSpeechendListener(@Nonnull
                                                     EventListener callback,
                                                     @Nonnull
                                                     EventListenerOptions options)

removeSpeechendListener

@JsOverlay
public final void removeSpeechendListener(@Nonnull
                                                     EventListener callback,
                                                     boolean useCapture)

removeSpeechendListener

@JsOverlay
public final void removeSpeechendListener(@Nonnull
                                                     EventListener callback)

addSpeechstartListener

@JsOverlay
public final void addSpeechstartListener(@Nonnull
                                                    EventListener callback,
                                                    @Nonnull
                                                    AddEventListenerOptions options)

addSpeechstartListener

@JsOverlay
public final void addSpeechstartListener(@Nonnull
                                                    EventListener callback,
                                                    boolean useCapture)

addSpeechstartListener

@JsOverlay
public final void addSpeechstartListener(@Nonnull
                                                    EventListener callback)

removeSpeechstartListener

@JsOverlay
public final void removeSpeechstartListener(@Nonnull
                                                       EventListener callback,
                                                       @Nonnull
                                                       EventListenerOptions options)

removeSpeechstartListener

@JsOverlay
public final void removeSpeechstartListener(@Nonnull
                                                       EventListener callback,
                                                       boolean useCapture)

removeSpeechstartListener

@JsOverlay
public final void removeSpeechstartListener(@Nonnull
                                                       EventListener callback)

addStartListener

@JsOverlay
public final void addStartListener(@Nonnull
                                              EventListener callback,
                                              @Nonnull
                                              AddEventListenerOptions options)

addStartListener

@JsOverlay
public final void addStartListener(@Nonnull
                                              EventListener callback,
                                              boolean useCapture)

addStartListener

@JsOverlay
public final void addStartListener(@Nonnull
                                              EventListener callback)

removeStartListener

@JsOverlay
public final void removeStartListener(@Nonnull
                                                 EventListener callback,
                                                 @Nonnull
                                                 EventListenerOptions options)

removeStartListener

@JsOverlay
public final void removeStartListener(@Nonnull
                                                 EventListener callback,
                                                 boolean useCapture)

removeStartListener

@JsOverlay
public final void removeStartListener(@Nonnull
                                                 EventListener callback)