[{"data":1,"prerenderedAt":970},["ShallowReactive",2],{"navigation":3,"\u002Fchangelog":129,"\u002Fchangelog-surround":967},[4,27,65,107,125],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":26},"Getting started","i-lucide-rocket","\u002Fgetting-started","1.getting-started",[10,14,18,22],{"title":11,"path":12,"stem":13},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction",{"title":15,"path":16,"stem":17},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F2.installation",{"title":19,"path":20,"stem":21},"Quick start","\u002Fgetting-started\u002Fquick-start","1.getting-started\u002F3.quick-start",{"title":23,"path":24,"stem":25},"MSRV","\u002Fgetting-started\u002Fmsrv","1.getting-started\u002F9.msrv",false,{"title":28,"icon":29,"path":30,"stem":31,"children":32,"page":26},"Client","i-lucide-plug-zap","\u002Fclient","2.client",[33,37,41,45,49,53,57,61],{"title":34,"path":35,"stem":36},"Configuration","\u002Fclient\u002Fconfiguration","2.client\u002F1.configuration",{"title":38,"path":39,"stem":40},"Events and acks","\u002Fclient\u002Fevents-and-acks","2.client\u002F2.events-and-acks",{"title":42,"path":43,"stem":44},"Connection state","\u002Fclient\u002Fconnection-state","2.client\u002F3.connection-state",{"title":46,"path":47,"stem":48},"Transports and proxies","\u002Fclient\u002Ftransports-and-proxies","2.client\u002F4.transports-and-proxies",{"title":50,"path":51,"stem":52},"TLS","\u002Fclient\u002Ftls","2.client\u002F5.tls",{"title":54,"path":55,"stem":56},"Errors","\u002Fclient\u002Ferrors","2.client\u002F6.errors",{"title":58,"path":59,"stem":60},"Debugging","\u002Fclient\u002Fdebugging","2.client\u002F7.debugging",{"title":62,"path":63,"stem":64},"Blocking client","\u002Fclient\u002Fblocking","2.client\u002F8.blocking",{"title":66,"icon":67,"path":68,"stem":69,"children":70,"page":26},"Tauri plugin","i-simple-icons-tauri","\u002Ftauri","3.tauri",[71,75,79,83,87,91,95,99,103],{"title":72,"path":73,"stem":74},"Setup","\u002Ftauri\u002Fsetup","3.tauri\u002F1.setup",{"title":76,"path":77,"stem":78},"JavaScript API","\u002Ftauri\u002Fjavascript-api","3.tauri\u002F2.javascript-api",{"title":80,"path":81,"stem":82},"Rust API","\u002Ftauri\u002Frust-api","3.tauri\u002F3.rust-api",{"title":84,"path":85,"stem":86},"Permissions","\u002Ftauri\u002Fpermissions","3.tauri\u002F4.permissions",{"title":88,"path":89,"stem":90},"Security","\u002Ftauri\u002Fsecurity","3.tauri\u002F5.security",{"title":92,"path":93,"stem":94},"Messages and errors","\u002Ftauri\u002Fmessages-and-errors","3.tauri\u002F6.messages-and-errors",{"title":96,"path":97,"stem":98},"Troubleshooting","\u002Ftauri\u002Ftroubleshooting","3.tauri\u002F7.troubleshooting",{"title":100,"path":101,"stem":102},"Example app","\u002Ftauri\u002Fexample","3.tauri\u002F8.example",{"title":104,"path":105,"stem":106},"Plugin changelog","\u002Ftauri\u002Fchangelog","3.tauri\u002F9.changelog",{"title":108,"icon":109,"path":110,"stem":111,"children":112,"page":26},"Guides","i-lucide-book-open","\u002Fguides","4.guides",[113,117,121],{"title":114,"path":115,"stem":116},"Migration from rust_socketio","\u002Fguides\u002Fmigration","4.guides\u002F1.migration",{"title":118,"path":119,"stem":120},"Comparison","\u002Fguides\u002Fcomparison","4.guides\u002F2.comparison",{"title":122,"path":123,"stem":124},"Contributing","\u002Fguides\u002Fcontributing","4.guides\u002F3.contributing",{"title":126,"path":127,"stem":128},"Changelog","\u002Fchangelog","9.changelog",{"id":130,"title":126,"body":131,"description":960,"extension":961,"links":962,"meta":963,"navigation":964,"path":127,"seo":965,"stem":128,"__hash__":966},"docs\u002F9.changelog.md",{"type":132,"value":133,"toc":939},"minimark",[134,138,155,163,170,175,186,190,235,239,363,367,429,433,452,459,472,475,711,714,823,826,910,914],[135,136,137],"p",{},"All notable changes to this project will be documented in this file.",[135,139,140,141,148,149,154],{},"The format is based on ",[142,143,147],"a",{"href":144,"rel":145},"https:\u002F\u002Fkeepachangelog.com\u002Fen\u002F1.1.0\u002F",[146],"nofollow","Keep a Changelog",",\nand this project adheres to ",[142,150,153],{"href":151,"rel":152},"https:\u002F\u002Fsemver.org\u002Fspec\u002Fv2.0.0.html",[146],"Semantic Versioning",".",[156,157,159],"h2",{"id":158},"unreleased",[160,161,162],"span",{},"Unreleased",[156,164,166,169],{"id":165},"_020-2026-11-21",[160,167,168],{},"0.2.0"," - 2026-11-21",[171,172,174],"h3",{"id":173},"breaking-changes","Breaking changes",[176,177,178],"ul",{},[179,180,181,185],"li",{},[182,183,184],"code",{},"engineio::Transport::set_base_url"," (and the transports' own) is removed: on polling it moved\nthe POSTs but not the long-poll GETs, on websocket it changed nothing. The transport URL is\nfixed at construction.",[171,187,189],{"id":188},"added","Added",[176,191,192,205],{},[179,193,194,197,198,201,202,204],{},[182,195,196],{},"WeakClient"," (",[182,199,200],{},"Client::downgrade","): a handle that does not keep the connection open, for\nhandlers and other things the client owns (a handler holding a ",[182,203,28],{}," kept it alive forever).",[179,206,207,208,211,212,211,215,218,219,211,222,211,225,211,228,231,232,154],{},"The blocking API has the async client's ",[182,209,210],{},"proxy",", ",[182,213,214],{},"no_proxy",[182,216,217],{},"connect_params_with",",\n",[182,220,221],{},"engine_url",[182,223,224],{},"on_any",[182,226,227],{},"on_state_change",[182,229,230],{},"off_any"," and ",[182,233,234],{},"recovered",[171,236,238],{"id":237},"changed","Changed",[176,240,241,261,273,292,295,303,317,327,352],{},[179,242,243,244,247,248,231,250,253,254,211,257,260],{},"One connection task owns the client's whole life across ",[182,245,246],{},"reconnect()",": one command channel\nand one event task for the client's lifetime. ",[182,249,246],{},[182,251,252],{},"disconnect()"," take effect in\nthe order they are called; ",[182,255,256],{},"connected()",[182,258,259],{},"id()"," and the emit checks follow the published\nstate, and a loss is published before the (bounded) engine teardown.",[179,262,263,265,266,269,270,272],{},[182,264,252],{}," from a handler: the ",[182,267,268],{},"Closed"," state still reaches ",[182,271,227],{}," (it was\ndropped), events received after it start no handler. \"Inside a handler\" is per client: a\nhandler of client A that disconnects client B waits for B's handlers as from outside.",[179,274,275,276,211,279,211,282,211,285,211,288,291],{},"engine.io callbacks (",[182,277,278],{},"on_open",[182,280,281],{},"on_data",[182,283,284],{},"on_packet",[182,286,287],{},"on_error",[182,289,290],{},"on_close",") run one at a\ntime in the order of the events (they were each a task of their own).",[179,293,294],{},"A polling handshake body with packets after the open packet (python-engineio sends what the\nconnect handler emitted) is accepted; those packets come first on the stream.",[179,296,297,298,302],{},"Documentation site at ",[142,299,300],{"href":300,"rel":301},"https:\u002F\u002Fs00d.github.io\u002Frust-socketio\u002F",[146],"; the README is short and links\nto it.",[179,304,305,306,231,309,312,313,316],{},"Polling POSTs are bounded like the long-poll GET (pingInterval + pingTimeout): a POST stuck\non a half-open connection no longer holds ",[182,307,308],{},"emit",[182,310,311],{},"disconnect"," until the kernel gives up.\n",[182,314,315],{},"PollingTransport::new"," bounds both by 60 s.",[179,318,319,322,323,326],{},[182,320,321],{},"engineio::ClientBuilder::build"," stays on polling when the websocket upgrade fails (a proxy\nthat drops ",[182,324,325],{},"Upgrade:","), like engine.io-client.",[179,328,329,330,211,333,211,336,211,339,211,342,345,346,211,349,351],{},"The engine.io query parameters (",[182,331,332],{},"EIO",[182,334,335],{},"transport",[182,337,338],{},"sid",[182,340,341],{},"t",[182,343,344],{},"b64",") are the client's own:\na caller's values for them (",[182,347,348],{},"query(..)",[182,350,217],{},", the URL) are dropped.",[179,353,354,355,358,359,362],{},"The ",[182,356,357],{},"wss"," connection offers only HTTP\u002F1.1 in ALPN, also with a ",[182,360,361],{},"TlsConfig"," shared with an\nHTTP\u002F2 client.",[171,364,366],{"id":365},"fixed","Fixed",[176,368,369,372,389,395,403,413,423],{},[179,370,371],{},"A panic in the synchronous part of an async handler (the closure body before its future)\nstopped the event task for good; it is contained like a panic inside the future.",[179,373,374,375,378,379,381,382,384,385,388],{},"A panic in the synchronous part of ",[182,376,377],{},"auth_with"," \u002F ",[182,380,217],{}," ended the connection\ntask instead of failing the attempt. In the blocking API a panicking ",[182,383,377],{}," became a\nmisleading ",[182,386,387],{},"InvalidAuth(\"must be a JSON object\")","; it is \"the auth_with function panicked\".",[179,390,391,394],{},[182,392,393],{},"AckSender::send"," with a payload that cannot be encoded counted the ack as sent; a valid\nretry sent nothing.",[179,396,397,399,400,402],{},[182,398,246],{}," left the old event task running when a handler was stuck past the drain bound:\ntwo event tasks broke the in-order guarantee. It is stopped like ",[182,401,252],{}," does.",[179,404,405,408,409,412],{},[182,406,407],{},"redact_query(false)"," showed ",[182,410,411],{},"user:password@"," of the URL in the logs; it is masked always.",[179,414,415,416,419,420,422],{},"engine.io: a transport that failed or ended (a websocket closed without a close packet,\n",[182,417,418],{},"Session ID unknown"," after a server restart) left the session marked open; ",[182,421,290],{}," fires\nonce for any way the session ends.",[179,424,425,426,428],{},"engine.io: a ping answered after ",[182,427,252],{}," no longer reports an error.",[171,430,432],{"id":431},"testing","Testing",[176,434,435,445],{},[179,436,437,440,441,444],{},[182,438,439],{},"socketio-next-testing::fake",": in-process Engine.IO v4 \u002F Socket.IO v4 servers with the\nfixtures of ",[182,442,443],{},"ci\u002F*.js",", written from the protocol. Most tests need no Node any more; Node stays\nfor the differential tests, connection state recovery, cookies and TLS.",[179,446,447,448,451],{},"CI on Linux, macOS and Windows for every push and pull request; Rust 1.100. Releases run from\nthe CI workflow with crates.io trusted publishing (",[182,449,450],{},"PUBLISHING.md",").",[156,453,455,458],{"id":454},"_010-2026-11-08",[160,456,457],{},"0.1.0"," - 2026-11-08",[135,460,461,462,465,466,471],{},"First release of ",[182,463,464],{},"socketio-next",", the successor of the s00d\u002Frust-socketio fork of\n",[142,467,470],{"href":468,"rel":469},"https:\u002F\u002Fgithub.com\u002F1c3t3a\u002Frust-socketio",[146],"rust_socketio"," 0.6.0 (its history is in that\nrepository). See \"Differences from rust_socketio\" in the README for the migration table.",[171,473,189],{"id":474},"added-1",[176,476,477,488,524,531,541,558,564,577,580,595,608,616,622,647,653,659,673,691],{},[179,478,479,480,483,484,487],{},"One crate: the socket.io client, ",[182,481,482],{},"engineio"," (transport layer) and ",[182,485,486],{},"protocol"," (codecs, no I\u002FO).",[179,489,490,491,378,494,378,497,500,501,504,505,378,508,378,511,378,513,516,517,520,521,523],{},"Socket.IO client with socket.io-client 4.8 behaviour: connection task + ordered event task,\n",[182,492,493],{},"ConnectionState",[182,495,496],{},"DisconnectReason",[182,498,499],{},"LinkInfo",", awaitable acks with timeout, server acks\nanswered (",[182,502,503],{},"Event::ack","), runtime ",[182,506,507],{},"on",[182,509,510],{},"once",[182,512,224],{},[182,514,515],{},"off",", sync or async handlers\nwithout boxing, ",[182,518,519],{},"buffer_while_disconnected"," (opt-in send buffer), connection state recovery,\n",[182,522,377],{},", query and headers, packet inspector, typed cloneable errors.",[179,525,526,527,530],{},"socket.io-parser binary encoding: several attachments, nested placeholders (",[182,528,529],{},"Payload::Mixed",");\nmaxAttachments 10; numeric and argument-less event names.",[179,532,533,534,537,538,451],{},"socket.io-client reconnection backoff (backo2, randomizationFactor 0.5, delay before every\nattempt); ",[182,535,536],{},"reconnection_attempts"," is final (",[182,539,540],{},"ReconnectFailed",[179,542,543,544,547,548,551,552,554,555,154],{},"TLS as a feature: ",[182,545,546],{},"rustls"," (default, ring + webpki roots), ",[182,549,550],{},"native-tls",", or none; ",[182,553,361],{},"\nwith ",[182,556,557],{},"with_root_certificates_pem",[179,559,560,563],{},[182,561,562],{},"blocking"," feature: the async client on a private runtime.",[179,565,566,569,570,573,574,451],{},[182,567,568],{},"TlsProviderMissing"," instead of a reqwest panic when another crate enabled reqwest's\n",[182,571,572],{},"rustls-no-provider"," (found integrating with a Tauri app using ",[182,575,576],{},"tauri-plugin-updater",[179,578,579],{},"tracing with spans per client and redacted query values; errors never carry URLs.",[179,581,582,583,586,587,590,591,594],{},"Differential tests against socket.io-client 4.8 (",[182,584,585],{},"ci\u002Fconformance","), Node test servers without\nDocker (",[182,588,589],{},"ci\u002Fservers.sh","), ",[182,592,593],{},"justfile",", CI on Linux, macOS and Windows.",[179,596,597,600,601,604,605,154],{},[182,598,599],{},"tauri-plugin-socketio"," (crate) and ",[182,602,603],{},"tauri-plugin-socketio-api"," (npm): a Tauri 2 plugin with\nnamed clients shared by Rust and the webviews; its own changelog is\n",[142,606,607],{"href":105},"crates\u002Ftauri-plugin-socketio\u002FCHANGELOG.md",[179,609,610,613,614,154],{},[182,611,612],{},"ClientBuilder::connect_params_with",": query parameters and headers computed before every\nconnect attempt (inside its timeout, panics contained), like ",[182,615,377],{},[179,617,618,621],{},[182,619,620],{},"Client::reconnect()"," (and blocking): connect a closed client again with the same handlers.",[179,623,624,231,627,378,630,378,633,378,636,639,640,643,644,154],{},[182,625,626],{},"ClientBuilder::proxy(..)",[182,628,629],{},"HTTPS_PROXY",[182,631,632],{},"HTTP_PROXY",[182,634,635],{},"ALL_PROXY",[182,637,638],{},"NO_PROXY"," for the\nwebsocket too (a ",[182,641,642],{},"CONNECT"," tunnel with basic auth); ",[182,645,646],{},"engineio::Error::ProxyFailed",[179,648,649,652],{},[182,650,651],{},"cookies"," feature: one cookie jar per client for polling and the websocket handshake.",[179,654,655,658],{},[182,656,657],{},"platform-verifier"," feature: rustls with the OS trust store (not on Android).",[179,660,661,664,665,668,669,672],{},[182,662,663],{},"engineio::Error::WebsocketClosed { code, reason }"," from close frames (also during the\nupgrade probe), a ",[182,666,667],{},"TransportClose","; ",[182,670,671],{},"ConnectionState::Disconnected"," carries the error.",[179,674,675,678,679,682,683,686,687,690],{},[182,676,677],{},"HttpStatus"," has engine.io's error message (",[182,680,681],{},"message",") when the body is its\n",[182,684,685],{},"{\"code\", \"message\"}"," JSON (at most 4 KiB read, 200 characters kept, URLs and queries\nremoved); any other body (HTML, text, other JSON) gives ",[182,688,689],{},"None",", since it may echo the\nrequest, a header or a token.",[179,692,693,695,696,378,699,211,702,378,705,211,708,154],{},[182,694,499],{},": ",[182,697,698],{},"packets_in",[182,700,701],{},"packets_out",[182,703,704],{},"bytes_in",[182,706,707],{},"bytes_out",[182,709,710],{},"sessions",[171,712,238],{"id":713},"changed-1",[176,715,716,756,791,797,800,811,814,820],{},[179,717,718,719,721,722,725,726,729,730,732,733,211,735,211,738,740,741,744,745,748,749,752,753,755],{},"Breaking (pre-release): ",[182,720,671],{}," has an ",[182,723,724],{},"error"," field and\n",[182,727,728],{},"engineio::Error::HttpStatus"," a ",[182,731,681],{}," field; the struct-like variants of\n",[182,734,493],{},[182,736,737],{},"Error::ConnectRejected",[182,739,728],{}," and\n",[182,742,743],{},"WebsocketClosed"," are ",[182,746,747],{},"#[non_exhaustive]"," (match them with ",[182,750,751],{},"..","), so fields can be added\nlater without a break. Code ported from rust_socketio matches states with ",[182,754,751],{}," anyway.",[179,757,758,759,211,761,211,763,211,765,767,768,771,772,774,775,778,779,782,783,786,787,790],{},"Environment proxies (",[182,760,629],{},[182,762,632],{},[182,764,635],{},[182,766,638],{},") now also apply to\nthe websocket, ",[182,769,770],{},"ws:\u002F\u002F"," included, with the same matcher reqwest uses for polling; a proxy that\nrefuses ",[182,773,642],{}," to non-443 ports refuses the websocket (with ",[182,776,777],{},"TransportType::Any"," the client\nstays on polling). ",[182,780,781],{},"ClientBuilder::no_proxy()"," turns proxies off for both transports.\n",[182,784,785],{},"https:\u002F\u002F"," and SOCKS proxies are a ",[182,788,789],{},"ProxyFailed"," error for the websocket.",[179,792,793,794,796],{},"Redirects are not followed (a 3xx is an ",[182,795,677],{}," error without the target).",[179,798,799],{},"The wall-clock check of the heartbeat probes the link and waits pingTimeout instead of\nclosing at once, so an NTP step on a live link does not disconnect.",[179,801,802,803,806,807,810],{},"A refused websocket handshake (3xx, 4xx) is ",[182,804,805],{},"HttpStatus { status }","; the response (with a\n",[182,808,809],{},"Location"," that may carry the query) is not kept in the error.",[179,812,813],{},"Environment proxies are read once, when the client is built; both transports use that\ndecision for the client's life.",[179,815,816,819],{},[182,817,818],{},"ClientBuilder::engine_url()",": the engine.io URL a connect will use (path normalized).",[179,821,822],{},"One reqwest client per socket.io client, shared by every transport and reconnect (it was\ntwo per connect attempt); only long-poll GETs are bounded by pingInterval + pingTimeout, so\nslow POST uploads are no longer cut.",[171,824,366],{"id":825},"fixed-1",[176,827,828,831,834,837,845,859,868,899],{},[179,829,830],{},"The heartbeat also checks the wall clock: after a system sleep a dead link is detected on\nwake-up instead of after the remaining monotonic time.",[179,832,833],{},"The websocket reader could miss a wakeup when another task held the receiver (a lock\nfuture polled once and dropped); the receiver is now polled under a short std lock.",[179,835,836],{},"The wall-clock liveness probe over polling goes through the normal write lock (a POST\nnext to another one made engine.io close the session with \"data request overlap\").",[179,838,839,841,842,844],{},[182,840,246],{}," racing ",[182,843,252],{},": a disconnect always wins (no revived client, no hang).",[179,846,847,848,851,852,855,856,858],{},"The caller's ",[182,849,850],{},"Cookie"," header and the cookie jar are merged (",[182,853,854],{},"user; jar",") on polling and on\nthe websocket handshake (",[182,857,651],{}," feature).",[179,860,861,862,864,865,451],{},"IPv6 servers and proxies through the ",[182,863,642],{}," tunnel (",[182,866,867],{},"[::1]",[179,869,870,873,874,876,877,880,881,211,884,886,887,890,891,894,895,898],{},[182,871,872],{},"connect().await"," could return before the client was connected: ",[182,875,256],{}," false,\n",[182,878,879],{},"state()"," ",[182,882,883],{},"Connecting",[182,885,259],{}," None and ",[182,888,889],{},"emit()"," failing with ",[182,892,893],{},"NotConnected"," on a\nmulti-thread runtime or with the blocking client. The connected state is now set before\n",[182,896,897],{},"connect()"," returns and after every reconnect.",[179,900,901,902],{},"Carried over from the fork, each with a regression test:",[176,903,904],{},[179,905,906,907,909],{},"Whole long-polling bodies; bounded handshakes; non-200 polling answers; websocket frames as\nsingle packets; unique ack ids; ",[182,908,252],{}," stops reconnects and hung attempts; the engine\ncloses after namespace disconnect, CONNECT_ERROR and decode errors; emits before CONNECT are\nbuffered; BINARY_EVENT for binary emits with ack; socket.io-parser validation rules; no\nunsolicited PONG.",[171,911,913],{"id":912},"removed","Removed",[176,915,916],{},[179,917,918,919,922,923,211,926,218,929,211,932,935,936,938],{},"The sync engine.io client and transports; ",[182,920,921],{},"Payload::String","; the ",[182,924,925],{},"backoff",[182,927,928],{},"adler32",[182,930,931],{},"async-stream",[182,933,934],{},"async-trait"," and direct ",[182,937,550],{}," dependencies.",{"title":940,"searchDepth":941,"depth":942,"links":943},"",2,3,[944,945,953],{"id":158,"depth":941,"text":162},{"id":165,"depth":941,"text":946,"children":947},"0.2.0 - 2026-11-21",[948,949,950,951,952],{"id":173,"depth":942,"text":174},{"id":188,"depth":942,"text":189},{"id":237,"depth":942,"text":238},{"id":365,"depth":942,"text":366},{"id":431,"depth":942,"text":432},{"id":454,"depth":941,"text":954,"children":955},"0.1.0 - 2026-11-08",[956,957,958,959],{"id":474,"depth":942,"text":189},{"id":713,"depth":942,"text":238},{"id":825,"depth":942,"text":366},{"id":912,"depth":942,"text":913},"All notable changes to socketio-next.","md",null,{},true,{"title":126,"description":960},"nsNXGzol3rwiwuYvPBu_HqfDJxMvK_UYkWk8nepJM1s",[968,962],{"title":122,"path":123,"stem":124,"description":969,"children":-1},"The justfile, the Node test servers, CI and the docs site.",1795285663244]