[{"data":1,"prerenderedAt":797},["ShallowReactive",2],{"navigation":3,"\u002Ftauri\u002Fmessages-and-errors":129,"\u002Ftauri\u002Fmessages-and-errors-surround":792},[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":92,"body":131,"description":785,"extension":786,"links":787,"meta":788,"navigation":789,"path":93,"seo":790,"stem":94,"__hash__":791},"docs\u002F3.tauri\u002F6.messages-and-errors.md",{"type":132,"value":133,"toc":779},"minimark",[134,143,148,151,294,309,313,459,492,500,504,519,522,540,775],[135,136,137,138,142],"p",{},"The JS API handles the channel for you; this page describes it for Rust-side channels (",[139,140,141],"code",{},"subscribe",") and for debugging.",[144,145,147],"h2",{"id":146},"channel-messages","Channel messages",[135,149,150],{},"A subscription's channel carries:",[152,153,158],"pre",{"className":154,"code":155,"language":156,"meta":157,"style":157},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","type Message =\n  | { type: 'state'; state: ConnectionState; snapshot?: boolean }\n  | { type: 'event'; event: string; args: unknown[]; binary?: number[][]; ackId?: number }\n","ts","",[139,159,160,177,228],{"__ignoreMap":157},[161,162,165,169,173],"span",{"class":163,"line":164},"line",1,[161,166,168],{"class":167},"spNyl","type",[161,170,172],{"class":171},"sBMFI"," Message",[161,174,176],{"class":175},"sMK4o"," =\n",[161,178,180,183,186,190,193,196,200,203,206,209,211,214,216,219,222,225],{"class":163,"line":179},2,[161,181,182],{"class":175},"  |",[161,184,185],{"class":175}," {",[161,187,189],{"class":188},"swJcz"," type",[161,191,192],{"class":175},":",[161,194,195],{"class":175}," '",[161,197,199],{"class":198},"sfazB","state",[161,201,202],{"class":175},"'",[161,204,205],{"class":175},";",[161,207,208],{"class":188}," state",[161,210,192],{"class":175},[161,212,213],{"class":171}," ConnectionState",[161,215,205],{"class":175},[161,217,218],{"class":188}," snapshot",[161,220,221],{"class":175},"?:",[161,223,224],{"class":171}," boolean",[161,226,227],{"class":175}," }\n",[161,229,231,233,235,237,239,241,244,246,248,251,253,256,258,261,263,266,270,272,275,277,280,283,285,288,290,292],{"class":163,"line":230},3,[161,232,182],{"class":175},[161,234,185],{"class":175},[161,236,189],{"class":188},[161,238,192],{"class":175},[161,240,195],{"class":175},[161,242,243],{"class":198},"event",[161,245,202],{"class":175},[161,247,205],{"class":175},[161,249,250],{"class":188}," event",[161,252,192],{"class":175},[161,254,255],{"class":171}," string",[161,257,205],{"class":175},[161,259,260],{"class":188}," args",[161,262,192],{"class":175},[161,264,265],{"class":171}," unknown",[161,267,269],{"class":268},"sTEyZ","[]",[161,271,205],{"class":175},[161,273,274],{"class":188}," binary",[161,276,221],{"class":175},[161,278,279],{"class":171}," number",[161,281,282],{"class":268},"[][]",[161,284,205],{"class":175},[161,286,287],{"class":188}," ackId",[161,289,221],{"class":175},[161,291,279],{"class":171},[161,293,227],{"class":175},[135,295,296,297,300,301,304,305,308],{},"The first state message carries ",[139,298,299],{},"snapshot: true",": the state at subscribe time, also returned by ",[139,302,303],{},"connect"," \u002F ",[139,306,307],{},"attach","; nothing older follows it on that channel.",[144,310,312],{"id":311},"states","States",[152,314,316],{"className":154,"code":315,"language":156,"meta":157,"style":157},"{ status: 'connecting', attempt }\n{ status: 'connected', sid, recovered }\n{ status: 'disconnected', reason, error? }\n{ status: 'reconnecting', attempt, delay, error? }\n{ status: 'closed', reason, error? }\n",[139,317,318,343,370,400,433],{"__ignoreMap":157},[161,319,320,323,326,328,330,333,335,338,341],{"class":163,"line":164},[161,321,322],{"class":175},"{",[161,324,325],{"class":171}," status",[161,327,192],{"class":175},[161,329,195],{"class":175},[161,331,332],{"class":198},"connecting",[161,334,202],{"class":175},[161,336,337],{"class":175},",",[161,339,340],{"class":268}," attempt",[161,342,227],{"class":175},[161,344,345,347,349,351,353,356,358,360,363,365,368],{"class":163,"line":179},[161,346,322],{"class":175},[161,348,325],{"class":171},[161,350,192],{"class":175},[161,352,195],{"class":175},[161,354,355],{"class":198},"connected",[161,357,202],{"class":175},[161,359,337],{"class":175},[161,361,362],{"class":268}," sid",[161,364,337],{"class":175},[161,366,367],{"class":268}," recovered",[161,369,227],{"class":175},[161,371,372,374,376,378,380,383,385,387,390,392,395,398],{"class":163,"line":230},[161,373,322],{"class":175},[161,375,325],{"class":171},[161,377,192],{"class":175},[161,379,195],{"class":175},[161,381,382],{"class":198},"disconnected",[161,384,202],{"class":175},[161,386,337],{"class":175},[161,388,389],{"class":268}," reason",[161,391,337],{"class":175},[161,393,394],{"class":268}," error",[161,396,397],{"class":175},"?",[161,399,227],{"class":188},[161,401,403,405,407,409,411,414,416,418,420,422,425,427,430],{"class":163,"line":402},4,[161,404,322],{"class":175},[161,406,325],{"class":188},[161,408,192],{"class":175},[161,410,195],{"class":175},[161,412,413],{"class":198},"reconnecting",[161,415,202],{"class":175},[161,417,337],{"class":175},[161,419,340],{"class":268},[161,421,337],{"class":175},[161,423,424],{"class":268}," delay",[161,426,337],{"class":175},[161,428,429],{"class":188}," error? ",[161,431,432],{"class":175},"}\n",[161,434,436,438,440,442,444,447,449,451,453,455,457],{"class":163,"line":435},5,[161,437,322],{"class":175},[161,439,325],{"class":188},[161,441,192],{"class":175},[161,443,195],{"class":175},[161,445,446],{"class":198},"closed",[161,448,202],{"class":175},[161,450,337],{"class":175},[161,452,389],{"class":268},[161,454,337],{"class":175},[161,456,429],{"class":188},[161,458,432],{"class":175},[135,460,461,462,465,466,465,469,465,472,465,475,465,478,481,482,465,485,465,488,491],{},"Reasons are socket.io-client's strings (",[139,463,464],{},"io server disconnect",", ",[139,467,468],{},"io client disconnect",[139,470,471],{},"ping timeout",[139,473,474],{},"transport close",[139,476,477],{},"transport error",[139,479,480],{},"parse error",") plus ",[139,483,484],{},"connect rejected",[139,486,487],{},"reconnect failed",[139,489,490],{},"client dropped",".",[135,493,494,495,465,497,499],{},"A failed first connect can send the attempt's states (",[139,496,332],{},[139,498,446],{},") on the channel before the promise rejects; guest-js drops that socket, the rejection is the answer.",[144,501,503],{"id":502},"server-acks","Server acks",[135,505,506,507,510,511,514,515,518],{},"A server ack gets one ",[139,508,509],{},"ackId",", offered to every webview subscribed to the event; the first answer wins, later ones fail with ",[139,512,513],{},"UnknownAck",". Acks wait for ",[139,516,517],{},"ACK_TTL"," (2 min). Once a disconnect starts, no ack is offered any more. Read-only clients offer no acks to webviews.",[144,520,54],{"id":521},"errors",[135,523,524,525,528,529,465,532,535,536,539],{},"Rejections are ",[139,526,527],{},"SocketIoError"," with ",[139,530,531],{},"kind",[139,533,534],{},"message"," and ",[139,537,538],{},"data",". Messages never contain URLs or query values.",[541,542,543,557],"table",{},[544,545,546],"thead",{},[547,548,549,554],"tr",{},[550,551,552],"th",{},[139,553,531],{},[550,555,556],{},"When",[558,559,560,577,587,610,620,630,640,650,659,672,682,692,714,726,736,765],"tbody",{},[547,561,562,568],{},[563,564,565],"td",{},[139,566,567],{},"ConnectRejected",[563,569,570,571,573,574],{},"the server's middleware refused the namespace; ",[139,572,538],{}," is its ",[139,575,576],{},"err.data",[547,578,579,584],{},[563,580,581],{},[139,582,583],{},"ConnectTimeout",[563,585,586],{},"the first connect attempt timed out",[547,588,589,603],{},[563,590,591,465,594,465,597,465,600],{},[139,592,593],{},"NotConnected",[139,595,596],{},"Disconnected",[139,598,599],{},"Closed",[139,601,602],{},"AckTimeout",[563,604,605,606],{},"as in the ",[607,608,609],"a",{"href":55},"Rust client",[547,611,612,617],{},[563,613,614],{},[139,615,616],{},"AccessDenied",[563,618,619],{},"the client is read-only",[547,621,622,627],{},[563,623,624],{},[139,625,626],{},"UnknownClient",[563,628,629],{},"no client with that id",[547,631,632,637],{},[563,633,634],{},[139,635,636],{},"AlreadyExists",[563,638,639],{},"the id is in use",[547,641,642,647],{},[563,643,644],{},[139,645,646],{},"Reserved",[563,648,649],{},"Rust reserved the id",[547,651,652,656],{},[563,653,654],{},[139,655,513],{},[563,657,658],{},"the ack was answered, expired or belongs to another client or webview",[547,660,661,666],{},[563,662,663],{},[139,664,665],{},"UrlNotAllowed",[563,667,668,669],{},"the URL is outside ",[139,670,671],{},"allow_url_prefix",[547,673,674,679],{},[563,675,676],{},[139,677,678],{},"TooManySubscriptions",[563,680,681],{},"the webview has 64 subscriptions",[547,683,684,689],{},[563,685,686],{},[139,687,688],{},"InvalidOptions",[563,690,691],{},"a wrong option type or value, or a refused header (the value is not echoed)",[547,693,694,699],{},[563,695,696],{},[139,697,698],{},"NotConfigurable",[563,700,701,304,704,304,707,304,710,713],{},[139,702,703],{},"setAuth",[139,705,706],{},"setHeaders",[139,708,709],{},"setQuery",[139,711,712],{},"reconnect"," on a client Rust connected",[547,715,716,721],{},[563,717,718],{},[139,719,720],{},"WebsocketClosed",[563,722,723],{},[139,724,725],{},"data: { code, reason }",[547,727,728,733],{},[563,729,730],{},[139,731,732],{},"ProxyFailed",[563,734,735],{},"the proxy refused",[547,737,738,753],{},[563,739,740,465,743,465,746,465,749,752],{},[139,741,742],{},"HttpStatus",[139,744,745],{},"Websocket",[139,747,748],{},"Http",[139,750,751],{},"TlsProviderMissing",", ...",[563,754,755,756,758,759,535,762],{},"engine failures by name; ",[139,757,742],{}," has ",[139,760,761],{},"data.status",[139,763,764],{},"data.message",[547,766,767,772],{},[563,768,769],{},[139,770,771],{},"Ipc",[563,773,774],{},"a rejection that is not the plugin's (a command the capability does not allow)",[776,777,778],"style",{},"html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":157,"searchDepth":179,"depth":230,"links":780},[781,782,783,784],{"id":146,"depth":179,"text":147},{"id":311,"depth":179,"text":312},{"id":502,"depth":179,"text":503},{"id":521,"depth":179,"text":54},"What a subscription's channel carries, the state objects, ack rules and SocketIoError kinds.","md",null,{},true,{"title":92,"description":785},"yXPxvozGznfWBwx_Yt9lc_L_9G0pxmMyO0bRc9crs-0",[793,795],{"title":88,"path":89,"stem":90,"description":794,"children":-1},"Reserved ids, read-only clients, the URL allow-list, refused headers and webview isolation.",{"title":96,"path":97,"stem":98,"description":796,"children":-1},"Common plugin errors and what to check.",1795285664119]