[{"data":1,"prerenderedAt":755},["ShallowReactive",2],{"navigation":3,"\u002Ftauri\u002Fchangelog":129,"\u002Ftauri\u002Fchangelog-surround":750},[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":104,"body":131,"description":743,"extension":744,"links":745,"meta":746,"navigation":747,"path":105,"seo":748,"stem":106,"__hash__":749},"docs\u002F3.tauri\u002F9.changelog.md",{"type":132,"value":133,"toc":725},"minimark",[134,147,164,172,179,183,229,233,257,261,327,331,345,349,393,400,404],[135,136,137,138,142,143,146],"p",{},"All notable changes to ",[139,140,141],"code",{},"tauri-plugin-socketio"," (crate) and ",[139,144,145],{},"tauri-plugin-socketio-api"," (npm)\nare documented in this file. Both are released together with the same version.",[135,148,149,150,157,158,163],{},"The format is based on ",[151,152,156],"a",{"href":153,"rel":154},"https:\u002F\u002Fkeepachangelog.com\u002Fen\u002F1.1.0\u002F",[155],"nofollow","Keep a Changelog",",\nand this project adheres to ",[151,159,162],{"href":160,"rel":161},"https:\u002F\u002Fsemver.org\u002Fspec\u002Fv2.0.0.html",[155],"Semantic Versioning",".",[165,166,168],"h2",{"id":167},"unreleased",[169,170,171],"span",{},"Unreleased",[165,173,175,178],{"id":174},"_020-2026-11-21",[169,176,177],{},"0.2.0"," - 2026-11-21",[180,181,88],"h3",{"id":182},"security",[184,185,186,205],"ul",{},[187,188,189,190,193,194,193,197,200,201,204],"li",{},"A webview may not set the ",[139,191,192],{},"Origin",", ",[139,195,196],{},"Forwarded",[139,198,199],{},"X-Forwarded-*"," and ",[139,202,203],{},"X-Real-IP"," headers\n(a page could pose as another origin or client address to the server).",[187,206,207,208,193,211,214,215,193,218,193,221,224,225,228],{},"A webview's query can no longer override engine.io's own parameters (",[139,209,210],{},"sid",[139,212,213],{},"EIO",",\n",[139,216,217],{},"transport",[139,219,220],{},"t",[139,222,223],{},"b64","): with a read-only client's engine sid from ",[139,226,227],{},"linkInfo",", a page could\ndisturb that client's polling session (socketio-next drops those keys now).",[180,230,232],{"id":231},"fixed","Fixed",[184,234,235,246],{},[187,236,237,238,241,242,245],{},"The clients a webview connected are disconnected when its window is destroyed (a reload keeps\nthem), and one webview may have at most ",[139,239,240],{},"MAX_CLIENTS_PER_WEBVIEW"," (64) at once\n(",[139,243,244],{},"TooManyClients","); before, a loop of connect + close left every client connected.",[187,247,248,249,252,253,256],{},"A ",[139,250,251],{},"reconnect"," racing a ",[139,254,255],{},"disconnect"," revived a client that was already unregistered; the\nrevived connection is closed again and the id reported unknown.",[180,258,260],{"id":259},"fixed-guest-js","Fixed (guest-js)",[184,262,263,284,287,296,309,324],{},[187,264,265,268,269,272,273,276,277,268,280,283],{},[139,266,267],{},"connect()"," \u002F ",[139,270,271],{},"attach()",": the messages that came before the call resolved are held until the\nsubscription's snapshot arrived, not for one fixed tick; a large event ahead of the snapshot\n(Tauri sends it by ",[139,274,275],{},"fetch",") made stale ",[139,278,279],{},"connecting",[139,281,282],{},"connected"," states fire again.",[187,285,286],{},"A throwing listener no longer stops the other listeners or the later messages; the error is\nrethrown on its own.",[187,288,289,292,293,163],{},[139,290,291],{},"off(event, fn)"," removes a listener added with ",[139,294,295],{},"once(event, fn)",[187,297,298,268,301,304,305,308],{},[139,299,300],{},"Blob",[139,302,303],{},"File"," arguments are read and sent as binary (they went out as ",[139,306,307],{},"{}",").",[187,310,311,312,315,316,319,320,323],{},"After ",[139,313,314],{},"disconnect()"," the socket reports ",[139,317,318],{},"closed"," (",[139,321,322],{},"io client disconnect",") right away.",[187,325,326],{},"A failed ack answer (expired, or answered by another socket of the webview) is logged instead\nof an unhandled promise rejection.",[180,328,330],{"id":329},"added-guest-js","Added (guest-js)",[184,332,333],{},[187,334,335,193,338,340,341,344],{},[139,336,337],{},"connect",[139,339,255],{}," (with the reason) and ",[139,342,343],{},"connect_error"," events from the state\ntransitions, as socket.io-client emits them.",[180,346,348],{"id":347},"changed","Changed",[184,350,351,359,369,376],{},[187,352,353,354,358],{},"Documentation at ",[151,355,356],{"href":356,"rel":357},"https:\u002F\u002Fs00d.github.io\u002Frust-socketio\u002Ftauri\u002Fsetup",[155],"; the README is short\nand links to it.",[187,360,361,362,365,366,308],{},"guest-js exports the ",[139,363,364],{},"WireArgs"," type (the return type of ",[139,367,368],{},"encodeArgs",[187,370,371,372,375],{},"guest-js needs ",[139,373,374],{},"@tauri-apps\u002Fapi"," 2.12.3 or newer (earlier versions stop a channel after a\nthrowing callback and leak channel callbacks).",[187,377,378,379,193,382,193,385,388,389,392],{},"Connect options in milliseconds (",[139,380,381],{},"timeout",[139,383,384],{},"reconnectionDelay",[139,386,387],{},"reconnectionDelayMax",") are\nread like ",[139,390,391],{},"emitWithAck","'s timeout: a fraction is cut (it was refused), a negative is refused.",[165,394,396,399],{"id":395},"_010-2026-11-08",[169,397,398],{},"0.1.0"," - 2026-11-08",[180,401,403],{"id":402},"added","Added",[184,405,406,409,457,514,517,524,530,543,552,566,572,604,642,661,674,686,697,704,714],{},[187,407,408],{},"First release: a registry of named socketio-next clients shared by Rust and the webviews.",[187,410,411,412,415,416,419,420,193,422,319,425,428,429,432,433,193,436,193,439,193,442,445,446,428,449,452,453,456],{},"Rust: ",[139,413,414],{},"SocketIoExt::socketio()"," → ",[139,417,418],{},"SocketIo"," with ",[139,421,337],{},[139,423,424],{},"insert",[139,426,427],{},"Access::Full"," \u002F\n",[139,430,431],{},"Access::ReadOnly","), ",[139,434,435],{},"get",[139,437,438],{},"access",[139,440,441],{},"ids",[139,443,444],{},"remove"," (never disconnects), ",[139,447,448],{},"subscribe",[139,450,451],{},"unsubscribe",". Ids are unique (",[139,454,455],{},"AlreadyExists",", no silent replacement).",[187,458,459,460,193,462,193,465,468,469,419,472,193,475,193,477,268,480,268,483,428,486,268,489,193,492,193,495,193,498,193,500,193,502,193,505,193,507,510,511,163],{},"JS: ",[139,461,337],{},[139,463,464],{},"attach",[139,466,467],{},"list","; ",[139,470,471],{},"Socket",[139,473,474],{},"emit",[139,476,391],{},[139,478,479],{},"on",[139,481,482],{},"once",[139,484,485],{},"off",[139,487,488],{},"onAny",[139,490,491],{},"offAny",[139,493,494],{},"onState",[139,496,497],{},"state",[139,499,227],{},[139,501,282],{},[139,503,504],{},"id",[139,506,255],{},[139,508,509],{},"close",";\ntyped ",[139,512,513],{},"SocketIoError { kind, message, data }",[187,515,516],{},"Per-subscription IPC channels (ordered, per webview) with an optional event filter; ended on\nunsubscribe, on a failed send, when the webview loads a new page or its window is destroyed,\nand when the client is removed.",[187,518,519,520,523],{},"Server acks answered from JS: one ",[139,521,522],{},"ackId"," per server ack for every subscribed webview,\nanswered once; 2 min TTL and a budget per webview; not offered for read-only clients or once a\ndisconnect started.",[187,525,526,529],{},[139,527,528],{},"SocketIo::reserve(id)",": ids Rust registers later cannot be taken by a page script.",[187,531,532,535,536,539,540,163],{},[139,533,534],{},"Builder::allow_url_prefix",": URL allow-list for webview connects (the CSP does not cover\nthese sockets); ",[139,537,538],{},"init()"," is ",[139,541,542],{},"Builder::new().build()",[187,544,545,546,200,548,551],{},"Webview isolation: ",[139,547,451],{},[139,549,550],{},"ack"," act only on the caller's subscriptions and acks;\nat most 64 subscriptions per webview.",[187,553,554,268,556,558,559,561,562,565],{},[139,555,337],{},[139,557,464],{}," resolve with the current state (the socket is ",[139,560,282],{}," right away);\nthe channel starts with that snapshot (",[139,563,564],{},"snapshot: true",") and nothing older follows it.",[187,567,568,569,571],{},"One forwarding hub per client: ending a subscription drops its channel; a reload during a\nJS ",[139,570,337],{}," leaves no subscription behind.",[187,573,574,268,577,268,580,583,584,193,587,193,590,593,594,596,597,599,600,603],{},[139,575,576],{},"setAuth",[139,578,579],{},"setHeaders",[139,581,582],{},"setQuery"," (commands ",[139,585,586],{},"set_auth",[139,588,589],{},"set_headers",[139,591,592],{},"set_query",") for\nclients a webview connected, read before every connect attempt; ",[139,595,251],{}," after ",[139,598,318],{},";\na ",[139,601,602],{},"ca"," option (PEM) for private CAs.",[187,605,606,608,609,268,612,193,615,268,618,193,621,468,624,627,628,419,631,634,635,638,639,163],{},[139,607,227],{}," has ",[139,610,611],{},"packetsIn",[139,613,614],{},"packetsOut",[139,616,617],{},"bytesIn",[139,619,620],{},"bytesOut",[139,622,623],{},"sessions",[139,625,626],{},"disconnected","\nstates carry the error (",[139,629,630],{},"WebsocketClosed",[139,632,633],{},"data: { code, reason }","); ",[139,636,637],{},"HttpStatus","\nerrors have ",[139,640,641],{},"data.message",[187,643,644,645,647,648,193,651,193,654,193,657,660],{},"The URL allow-list checks the engine.io path the connection uses (not the URL path, which\nis the namespace); concurrent connects hold their id and subscription slot, so they cannot\npass the per-webview cap; ",[139,646,251],{}," only for clients a webview connected; headers the\nwebview may not set (",[139,649,650],{},"Host",[139,652,653],{},"Cookie",[139,655,656],{},"Sec-WebSocket-*",[139,658,659],{},"Proxy-*",", ...).",[187,662,663,664,193,667,670,671,163],{},"The URL allow-list compares the URL socketio-next really builds (dot segments resolved) and\nrefuses ",[139,665,666],{},"..",[139,668,669],{},"%2e"," and backslashes in ",[139,672,673],{},"path",[187,675,676,200,679,682,683,163],{},[139,677,678],{},"State",[139,680,681],{},"Message"," and their struct-like variants are ",[139,684,685],{},"#[non_exhaustive]",[187,687,688,689,692,693,696],{},"Typed ",[139,690,691],{},"InvalidOptions"," for wrong option types\u002Fvalues (values are not echoed); connect\noptions' ",[139,694,695],{},"Debug"," hides query, header and auth values.",[187,698,699,700,703],{},"Binary arguments both ways (",[139,701,702],{},"Uint8Array"," ↔ socket.io attachments).",[187,705,706,707,710,711,163],{},"Permissions per command, ",[139,708,709],{},"socketio:allow-read"," (observe only) and ",[139,712,713],{},"socketio:default",[187,715,716,717,720,721,724],{},"Features ",[139,718,719],{},"rustls"," (default) and ",[139,722,723],{},"native-tls",", forwarded to socketio-next.",{"title":726,"searchDepth":727,"depth":728,"links":729},"",2,3,[730,731,739],{"id":167,"depth":727,"text":171},{"id":174,"depth":727,"text":732,"children":733},"0.2.0 - 2026-11-21",[734,735,736,737,738],{"id":182,"depth":728,"text":88},{"id":231,"depth":728,"text":232},{"id":259,"depth":728,"text":260},{"id":329,"depth":728,"text":330},{"id":347,"depth":728,"text":348},{"id":395,"depth":727,"text":740,"children":741},"0.1.0 - 2026-11-08",[742],{"id":402,"depth":728,"text":403},"All notable changes to tauri-plugin-socketio and tauri-plugin-socketio-api.","md",null,{},true,{"title":104,"description":743},"i44CA-34ggjCw2J7iZnSxL0kWkm02nzL8RNWcXoorVE",[751,753],{"title":100,"path":101,"stem":102,"description":752,"children":-1},"A Tauri app with a read-only client owned by Rust and a client of the webview.",{"title":114,"path":115,"stem":116,"description":754,"children":-1},"What changed from rust_socketio 0.6, the fixes and additions, and a mapping table.",1795285664191]