Frontmatter imports are now valid YAML (`import:` / `导入:` with bind→target entries), removing spaced keys. Add `marqdo migrate imports`, hard-error the old one-liner form, and migrate lib/ext/examples/tests/docs accordingly. Co-authored-by: Cursor <cursoragent@cursor.com>
44 lines
943 B
Markdown
44 lines
943 B
Markdown
---
|
||
markup: occlusion
|
||
title: ext/net/websocket
|
||
description: WebSocket client Resource (ADR 0007).
|
||
import:
|
||
plugin: lib/plugin.mq.md
|
||
sys: lib/sys.mq.md
|
||
table: lib/table.mq.md
|
||
---
|
||
|
||
## _load
|
||
|
||
**p = > plugin.native_path name="web"**
|
||
1. `p`
|
||
> plugin.load path=`p`
|
||
2. *
|
||
> print text=ext/net: native web plugin not found
|
||
> sys.exit code=1
|
||
****
|
||
|
||
# ws
|
||
+ `timeout_sec`=30
|
||
|
||
WebSocket client helper.
|
||
|
||
> _load
|
||
`out` =
|
||
|
||
| timeout_sec | _type |
|
||
|-------------|-------|
|
||
| `timeout_sec` | ws |
|
||
|
||
*out*
|
||
|
||
## connect
|
||
+ `url`
|
||
+ `message`=""
|
||
+ `headers`=None
|
||
|
||
Single request–response: connect to `url`, send `message`, collect up to 256 server text replies (each up to 1 MiB), close. Transport errors and timeouts return `{ok:false, error}` instead of looking like an empty successful reply.
|
||
|
||
**timeout = [timeout_sec](access(self, "timeout_sec"))**
|
||
*> web_ws_connect url=`url` message=`message` headers=`headers` timeout_sec=`timeout`*
|