Šajā sadaļā ir aprakstīti Zabbix papildinājumi JavaScript valodai, kas ieviesti ar Duktape izmantošanai Pārlūka vienuma skriptā. Šie papildinājumi papildina JavaScript objektus, kas aprakstīti lapā Papildu JavaScript objekti.

Browser

Browser objekts pārvalda WebDriver sesijas, inicializējot sesiju izveides brīdī un pārtraucot to iznīcināšanas brīdī. Viens skripts var atbalstīt līdz četriem Browser objektiem.

Lai izveidotu Browser objektu, izmantojiet sintaksi new Browser(options). Parametrs options (JSON objekts) norāda pārlūkprogrammas opcijas, parasti WebDriver opciju metodes rezultātu (piemēram, Browser.chromeOptions()).

Ar Browser objektu ir pieejamas šādas metodes.

Method	Description
`navigate(url)`	Pāriet uz norādīto URL. Parameters: `url` - (string) URL, uz kuru pāriet.
`getUrl()`	Atgriež atvērtās lapas URL kā virkni.
`getPageSource()`	Atgriež atvērtās lapas pirmkodu kā virkni.
`findElement(strategy, selector)`	Atgriež `Element` objektu ar vienu elementu atvērtajā lapā (vai atgriež `null`, ja neviens elements neatbilst `strategy` un `selector`). Parameters: `strategy` - (string, css selector/link text/partial link text/tag name/xpath) Location strategy; `selector` - (string) Elementa atlasītājs, izmantojot norādīto atrašanās vietas stratēģiju.
`findElements(strategy, target)`	Atgriež `Element` objektu masīvu ar vairākiem elementiem atvērtajā lapā (vai atgriež tukšu masīvu, ja neviens elements neatbilst atrašanās vietas stratēģijai un mērķim). Parameters: `strategy` - (string, css selector/link text/partial link text/tag name/xpath) Location strategy; `target` - (string) Elementa atlasītājs, izmantojot norādīto atrašanās vietas stratēģiju.
`getCookies()`	Atgriež `Cookie` objektu masīvu.
`addCookie(cookie)`	Iestata sīkdatnes. Parameters: `cookie` - (`Cookie` object) Iestatāmā sīkdatne.
`getScreenshot()`	Atgriež Base64 kodētu virkni, kas attēlo pārlūkprogrammas skatpunkta attēlu.
`setScreenSize(x,y)`	Iestata pārlūkprogrammas skatpunkta izmēru. Parameters: `x` - (string) Platums pikseļos; `y` - (string) Augstums pikseļos.
`setScriptTimeout(timeout)`	Iestata skripta ielādes noildzi. Parameters: `timeout` - (integer) Noildzes vērtība milisekundēs.
`setSessionTimeout(timeout)`	Iestata sesijas (lapas ielādes) noildzi. Parameters: `timeout` - (integer) Noildzes vērtība milisekundēs.
`setElementWaitTimeout(timeout)`	Iestata elementa atrašanas stratēģijas (netiešo) noildzi. Parameters: `timeout` - (integer) Noildzes vērtība milisekundēs.
`collectPerfEntries(mark)`	Apkopo veiktspējas ierakstus, lai tos izgūtu ar metodi `getResult()`. Parameters: `mark` - (string, optional) Veiktspējas momentuzņēmuma atzīme.
`getRawPerfEntries()`	Atgriež veiktspējas ierakstu objektu masīvu.
`getResult()`	Atgriež `Result` objektu ar pārlūkprogrammas sesijas statistiku (kļūdu informāciju, veiktspējas momentuzņēmumiem u. c.).
`getError()`	Atgriež `BrowserError` objektu ar pārlūkprogrammas kļūdām (vai atgriež `null`, ja pārlūkprogrammas kļūdu nav).
`setError(message)`	Iestata pielāgotu kļūdas ziņojumu, kas tiks iekļauts `Result` objektā. Parameters: `message` - (string) Kļūdas ziņojums.
`discardError()`	Atmet kļūdu, kas tiks atgriezta `Result` objektā.
`getAlert()`	Atgriež `Alert` objektu ar pārlūkprogrammas brīdinājumiem (vai atgriež `null`, ja pārlūkprogrammas brīdinājumu nav).
`chromeOptions()`	Atgriež `chromeOptions` objektu ar iepriekš definētām Chrome pārlūkprogrammas opcijām.
`firefoxOptions()`	Atgriež `firefoxOptions` objektu ar iepriekš definētām Firefox pārlūkprogrammas opcijām.
`safariOptions()`	Atgriež `safariOptions` objektu ar iepriekš definētām Safari pārlūkprogrammas opcijām.
`edgeOptions()`	Atgriež `edgeOptions` objektu ar iepriekš definētām Edge pārlūkprogrammas opcijām.
`switchFrame(target)`	Pārslēdzas uz norādīto rāmi. Atbalstīts kopš versijas 7.0.4. Parameters: `target` - (browser element or integer, optional) Mērķa rāmis. Lai atlasītu rāmi pēc elementa, nododiet elementu. Lai atlasītu rāmi pēc indeksa, nododiet skaitli. Ja atstāts tukšs, tiks pārslēgts uz augšējā līmeņa pārlūkošanas kontekstu.

Visas Browser metodes var izraisīt šādas kļūdas:

BrowserError - atvasināta no Error objekta, kas tiek izraisīta, ja Browser konstruktors neizdodas; satur papildu browser īpašību ar Browser objektu, kas izraisīja šo BrowserError.
WebdriverError - atvasināta no BrowserError; satur tās pašas īpašības kā BrowserError objekts, kas norāda, vai kļūda tika ģenerēta, reaģējot uz kļūdu WebDriver atbildē.

Elements

Element objekts tiek atgriezts ar Browser objekta findElement()/findElements() metodēm, un to nevar izveidot tieši.

Element objekts attēlo elementu tīmekļa lapā un nodrošina metodes mijiedarbībai ar to.

Ar Element objektu tiek atbalstītas šādas metodes.

Method	Description
`getAttribute(name)`	Atgriež elementa atribūta vērtību kā virkni (vai atgriež `null`, ja norādītais atribūts netika atrasts). Parameters: `name` - (string) Atribūta nosaukums.
`getProperty(name)`	Atgriež elementa īpašības vērtību kā virkni (vai atgriež `null`, ja norādītā īpašība netika atrasta). Parameters: `name` - (string) Īpašības nosaukums.
`getText()`	Atgriež elementa teksta vērtību kā virkni.
`click()`	Noklikšķina uz elementa.
`clear()`	Notīra rediģējama elementa saturu.
`sendKeys(keys)`	Nosūta taustiņsitienus. Parameters: `keys` - (string) Nosūtāmie taustiņsitieni.

Objektu Cookie atgriež objekta Browser metode getCookies(), un tas tiek nodots metodei addCookie().

Lai gan objektam Cookie nav metožu, tas var saturēt šādas īpašības:

Īpašība	Type	Apraksts
name	string	Sīkdatnes nosaukums.
value	string	Sīkdatnes vērtība.
path	string	Ceļš, kuram sīkdatne ir derīga. Ja, pievienojot sīkdatni, tas nav norādīts, pēc noklusējuma tiek izmantots `"/"`.
domain	string	Domēns, kurā sīkdatne ir redzama. Ja, pievienojot sīkdatni, tas nav norādīts, pēc noklusējuma tiek izmantots sesijas pašreizējā pārlūkošanas konteksta aktīvā dokumenta URL domēns.
secure	boolean	Norāda, vai sīkdatne ir droša. Ja, pievienojot sīkdatni, tas nav norādīts, pēc noklusējuma tiek izmantots `false`.
httpOnly	boolean	Norāda, vai sīkdatne ir tikai HTTP. Ja, pievienojot sīkdatni, tas nav norādīts, pēc noklusējuma tiek izmantots `false`.
expiry	integer	Sīkdatnes derīguma termiņš (sekundēs kopš Unix laikmeta sākuma). To nedrīkst iestatīt, ja, pievienojot sīkdatni, tas nav norādīts.
sameSite	string	Sīkdatnes atribūts `sameSite`, kas nosaka, vai sīkdatnei jābūt ierobežotai līdz pirmās puses vai tās pašas vietnes kontekstam. Var iestatīt uz `"Lax"` vai `"Strict"`. Ja, pievienojot sīkdatni, tas nav norādīts, pēc noklusējuma tiek izmantots `"None"`.

Brīdinājums

Objekts Alert attēlo tīmekļa lapas brīdinājumu, to atgriež objekta Browser metode getAlert(), un to nevar izveidot tieši.

Objekts Alert satur rekvizītu text ar brīdinājuma tekstu (vai null, ja brīdinājumu nav).

Ar objektu Alert tiek atbalstītas šādas metodes.

Method	Description
`accept()`	Apstiprināt brīdinājumu.
`dismiss()`	Noraidīt brīdinājumu.

Rezultāts

Objekts Result satur sesijas statistiku un tiek atgriezts ar objekta Browser metodi getResult().

Parasti objekts Result tiek pārveidots par virkni un atgriezts no skripta, bet pēc tam, izmantojot priekšapstrādi, parsēts atkarīgo vienumu vērtībās.

Lai gan objektam Result nav metožu, tas var saturēt tālāk norādītās īpašības.

Īpašība			Type	Apraksts
duration			string	Sesijas ilgums no sesijas izveides līdz rezultāta iegūšanai.
error			object	Kļūdas informācija.
	http_status		integer	HTTP statuss, ko atgrieza WebDriver (vai 0, ja nav WebDriver kļūdu).
	error_code		string	Kļūda, ko atgrieza WebDriver (vai tukša virkne, ja nav WebDriver kļūdu).
	message		string	WebDriver kļūdas ziņojums (vai tukša virkne, ja nav WebDriver kļūdu).
performance_data			object	Veiktspējas statistika.
	summary		object	Veiktspējas kopsavilkums.
	navigation	object	Navigācijas kopsavilkums.
	resource	object	Resursu kopsavilkums.
	details		array of objects	Veiktspējas statistika pēc katras darbības, kas varēja izraisīt navigāciju.
	mark	string	(neobligāti) Veiktspējas momentuzņēmuma atzīme, kas norādīta ar metodi `collectPerfEntries()`.
	navigation	object	Navigācijas statistika.
	resource	object	Šīs darbības resursu kopsavilkums.
	user	array of objects	Masīvs ar mark/measure tipa statistiku.
	marks		array of objects	Atzīmēto veiktspējas momentuzņēmumu indeksu masīvs.
	name	string	Veiktspējas momentuzņēmuma atzīmes nosaukums.
	index	integer	Veiktspējas momentuzņēmuma indekss masīvā details.

What’s next?

6 CSV uz JSON priekšapstrāde

Docs

2 Pārlūka vienuma JavaScript objekti

Pārskats

Browser

Elements

Cookie

Brīdinājums

Rezultāts

What’s next?

Suggest edit

Suggest an example

Thank you!