2025-11-05 17:04:23 -03:00

38 lines
984 B
Markdown

# URI
XMPP URIs for JavaScript
Only parsing is supported at the moment.
## Install
```sh
npm install @xmpp/uri
```
## Usage
```javascript
import { parse } from "@xmpp/uri";
parse('xmpp://guest@example.com/support@example.com/truc?message;subject=Hello%20World');
{
authority: jid('guest@example.com'), // see https://github.com/xmppjs/xmpp.js/tree/main/packages/jid
path: jid('support@example.com/truc'), // see https://github.com/xmppjs/xmpp.js/tree/main/packages/jid
query: {
type: 'message',
params: {
subject: 'Hello World',
},
},
}
```
## References
- [RFC 5122 Internationalized Resource Identifiers (IRIs) and Uniform Resource Identifiers (URIs) for the Extensible Messaging and Presence Protocol (XMPP)](https://xmpp.org/rfcs/rfc5122.html)
- [XEP-0147: XMPP URI Scheme Query Components](https://xmpp.org/extensions/xep-0147.html)
- [XMPP URI/IRI Querytypes](https://xmpp.org/registrar/querytypes.html)
- https://wiki.xmpp.org/web/XMPP_URIs