Skip to contents

Find the first match and push it as the current scope

Source: R/scope.R
pz_find_first.Rd

pz_find_first() is pz_find() with which = "first". With a target, it pins the spec's first match. Without a target, it narrows the current scope to its first element: one eager slice of the pinned set, with no re-query and no waiting.

Usage

pz_find_first(ctx, target = NULL, ..., from_root = FALSE)

Arguments

ctx

A paparazzi context.

target

A CSS selector string or a pz_loc() spec. NULL narrows the current scope; a union can't pick one match by position, and a spec that already carries which is an error.

...

Checked empty; reserved for future use.

from_root

Resolve the target from the page root instead of the current scope? Requires a target.

Value

A new context.

See also

pz_find(), pz_find_last(), pz_find_nth()

Examples

page <- pz_open(pz_example("tasks"))
page |>
  pz_find_first(".task") |>
  pz_get_text(target = ".task-title")
#> [1] "Renew passport"

# Without a target, narrow the current scope to its first element
page |>
  pz_find(".task[data-priority='normal']") |>
  pz_find_first() |>
  pz_get_text(target = ".task-title")
#> [1] "Book dentist appointment"
pz_close(page)