# Прочитать URL

Тип узла: `browser_getUrl`

## Назначение

Читает полный адрес, origin или один параметр query текущей страницы.

## Настройки в настольном клиенте

![Настройки узла «Прочитать URL» в настольном клиенте](/assets/get-url-en.f527c94150d497824041e85845bc0753636fd52c399d567df9b7df075e92f21b.0538f3a9.webp)

Снимок сделан в английском интерфейсе MoreLogin Desktop V2.73.101.

## Входные данные

Эти поля указываются в `data.browserUi.inputs`.

| Поле | Тип или значения | Обязательно по схеме | По умолчанию при выполнении | Описание и ограничения |
|  --- | --- | --- | --- | --- |
| `type` | `"href"` / `"origin"` / `"search"` (поддерживает ссылки на переменные) | Нет | `"href"` | Тип извлечения. Начальное значение в редакторе: `"href"` |
| `key` | `string` | Нет | — | Имя параметра |


## Требования к режимам и ограничения

**`type` `eq` `"search"`**

- Обязательное поле: `key`
- Для href value совпадает с url: оба содержат полный URL текущей страницы на момент чтения (включая query/hash; после перехода это может быть адрес перенаправления). Для origin value содержит протокол+хост+порт. Для search key после вычисления должен быть непустой строкой. Для повторяющегося ключа query value берёт первое вхождение, а словарь query сохраняет последнее. Если ключ не существует, возвращается пустая строка.
- Код ошибки проверки: `RPA_NODE_INPUT_INVALID`
- При type=search нужен key. Если параметр не существует, value равно пустой строке "".
- Код ошибки проверки: `RPA_NODE_INPUT_INVALID`


## Ссылки во входных данных

| Поле | Допустимые формы |
|  --- | --- |
| `type` | `literal`, `template` |
| `key` | `literal`, `template` |


## Выходные данные

**Режим** `type` `eq` `"href"`

| Поле выходных данных | Тип или значения |
|  --- | --- |
| `value` | `string` |
| `url` | `string` |
| `origin` | `string` |
| `pathname` | `string` |
| `query` | `object` |


**Режим** `type` `eq` `"origin"`

| Поле выходных данных | Тип или значения |
|  --- | --- |
| `value` | `string` |
| `url` | `string` |
| `origin` | `string` |
| `pathname` | `string` |
| `query` | `object` |


**Режим** `type` `eq` `"search"`

| Поле выходных данных | Тип или значения |
|  --- | --- |
| `value` | `string` / `null` |
| `url` | `string` |
| `origin` | `string` |
| `pathname` | `string` |
| `query` | `object` |


Ссылайтесь на опубликованные поля в виде `${nodeId.data.field}`.

## Пример JSON

В этом примере параметр query `item` читается в `data.value`. Для полного URL используйте `type: "href"`, а только для origin используйте `type: "origin"`.

```json
{
  "id": "read_url",
  "type": "browser_getUrl",
  "data": {
    "title": "Read the item query parameter",
    "browserAction": "getUrl",
    "browserUi": {
      "inputs": {
        "type": "search",
        "key": "item"
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}
```

[Назад к каталогу узлов](/ru/browser-rpa/nodes)