Правильный формат пути к элементу

В официальной документации нет примеров strategy=value, поскольку рекомендуемый синтаксис — strategy:value. Однако, если вы посмотрите на другую похожую библиотеку под названием Библиотека браузера, вы обнаружите, что они использовали синтаксис strategy=value. Я думаю, это просто зависит от библиотеки и ее рекомендаций.

Python позволяет передавать аргументы метода/функции вне порядка, когда вы упоминаете имя аргумента. Например:

def foo(x, y):
  print(f"x: {x}")
  print(f"y: {y}")

foo(1,2)
foo(y=1,x=2)

Скорее всего, это связано с тем, как реализованы kwargs в Python. Поскольку сам робот работает на Python, он соблюдает это соглашение.

Наиболее типичным местом использования этого соглашения является использование кваргов, но в данном конкретном случае локатор является обычным позиционным аргументом, поскольку это ключевое слово выглядит следующим образом:

    @keyword
    def wait_until_page_contains_element(
        self,
        locator: Union[WebElement, None, str],
        timeout: Optional[timedelta] = None,
        error: Optional[str] = None,
        limit: Optional[int] = None,
    ):

В этом случае необязательными являются только таймаут, ошибка и лимит (например, они имеют значение по умолчанию, если значение не передано).

Таким образом, передача аргумента ключевому слову в формате, в котором упоминается имя его переменной, скорее всего, служит своего рода документацией. Определение того, что первым аргументом должен быть локатор, означает явное утверждение, а если он опущен, то это только неявно и полагается на тот факт, что вызывающая сторона знает порядок аргументов.