Version: 1.3.0
Selectors
Selectors can be used to install custom selector engines. See Working with selectors) for more information.
#
selectors.register(name, script[, options])name
<string> Name that is used in selectors as a prefix, e.g.{name: 'foo'}
enablesfoo=myselectorbody
selectors. May only contain[a-zA-Z0-9_]
characters.script
<function|string|Object> Script that evaluates to a selector engine instance.path
<string> Path to the JavaScript file. Ifpath
is a relative path, then it is resolved relative to current working directory.content
<string> Raw script content.
options
<Object>contentScript
<boolean> Whether to run this selector engine in isolated JavaScript environment. This environment has access to the same DOM, but not any JavaScript objects from the frame's scripts. Defaults tofalse
. Note that running as a content script is not guaranteed when this engine is used together with other registered engines.
- returns: <Promise>
An example of registering selector engine that queries elements based on a tag name: