# openuri

Handing a URI to the operating system so that the user's chosen application
opens it, the way clicking a link in a document would.

## Language

**URI**:
The text the caller asks to have opened, beginning with a scheme such as
`https:` or `mailto:`.
_Avoid_: URL, link, address

**Handler**:
The application the operating system or the user picks to open a URI — a
browser for `https:`, a mail client for `mailto:`.
_Avoid_: browser, default app, opener

**Open request**:
One call asking the operating system to hand a URI to its handler.
_Avoid_: launch, open call

**Outcome**:
What an open request ended in: the URI was **opened** by a handler, or the
user **cancelled** the choice of handler.
_Avoid_: response, status

**Portal**:
The desktop service on Linux (`xdg-desktop-portal`) that receives open
requests on an application's behalf and decides on the handler, asking the
user when it has to.
_Avoid_: desktop service, xdg

**Parent window**:
The caller's own window, named so that any dialog the portal shows is placed
over it.
_Avoid_: owner window, transient parent

**Activation token**:
A token from the caller's windowing system that lets the handler's window take
focus rather than open behind the caller.
_Avoid_: startup id, focus token