[{"data":1,"prerenderedAt":1646},["ShallowReactive",2],{"navigation":3,"\u002Fclient\u002Fevents-and-acks":129,"\u002Fclient\u002Fevents-and-acks-surround":1641},[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":38,"body":131,"description":1635,"extension":1636,"links":1637,"meta":1638,"navigation":425,"path":39,"seo":1639,"stem":40,"__hash__":1640},"docs\u002F2.client\u002F2.events-and-acks.md",{"type":132,"value":133,"toc":1626},"minimark",[134,139,155,173,192,202,380,701,822,828,832,921,924,1072,1103,1134,1138,1274,1291,1295,1314,1316,1414,1435,1439,1466,1622],[135,136,138],"h2",{"id":137},"handlers","Handlers",[140,141,142,143,147,148,151,152,154],"p",{},"A handler gets an ",[144,145,146],"code",{},"Event"," (name, ",[144,149,150],{},"Payload",", ack) and the ",[144,153,28],{},". Write it as:",[156,157,158,167],"ul",{},[159,160,161,162,166],"li",{},"a ",[163,164,165],"strong",{},"closure returning a future",": runs on the client's event task;",[159,168,161,169,172],{},[163,170,171],{},"plain closure",": runs on tokio's blocking pool and may block.",[140,174,175,176,179,180,183,184,187,188,191],{},"No boxing is needed. Handlers run ",[163,177,178],{},"one at a time, in arrival order",", on one event task for the client's whole life. A handler may emit, await acks, add handlers and call ",[144,181,182],{},"disconnect()"," without deadlocks (no event handler starts after it; the ",[144,185,186],{},"Closed"," state still reaches ",[144,189,190],{},"on_state_change","). A panicking handler, even one that panics before it returns its future, is contained and does not stop the client.",[140,193,194,195,197,198,201],{},"A handler that keeps a ",[144,196,28],{}," of its own (captured in the closure) keeps the client alive for good, since the client owns its handlers. Capture a ",[144,199,200],{},"WeakClient"," instead:",[203,204,209],"pre",{"className":205,"code":206,"language":207,"meta":208,"style":208},"language-rust shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","let weak = client.downgrade();\nclient.on(\"ping\", move |_: Event, _: Client| {\n    if let Some(client) = weak.upgrade() {\n        let _ = client.emit(\"pong\", ());\n    }\n});\n","rust","",[144,210,211,241,300,336,368,374],{"__ignoreMap":208},[212,213,216,220,224,228,231,234,238],"span",{"class":214,"line":215},"line",1,[212,217,219],{"class":218},"spNyl","let",[212,221,223],{"class":222},"sTEyZ"," weak ",[212,225,227],{"class":226},"sMK4o","=",[212,229,230],{"class":222}," client",[212,232,233],{"class":226},".",[212,235,237],{"class":236},"s2Zo4","downgrade",[212,239,240],{"class":226},"();\n",[212,242,244,247,249,252,255,258,262,264,267,271,274,277,280,284,286,289,291,294,297],{"class":214,"line":243},2,[212,245,246],{"class":222},"client",[212,248,233],{"class":226},[212,250,251],{"class":236},"on",[212,253,254],{"class":226},"(",[212,256,257],{"class":226},"\"",[212,259,261],{"class":260},"sfazB","ping",[212,263,257],{"class":226},[212,265,266],{"class":226},",",[212,268,270],{"class":269},"sbssI"," move",[212,272,273],{"class":226}," |",[212,275,276],{"class":222},"_",[212,278,279],{"class":226},":",[212,281,283],{"class":282},"sBMFI"," Event",[212,285,266],{"class":226},[212,287,288],{"class":222}," _",[212,290,279],{"class":226},[212,292,293],{"class":282}," Client",[212,295,296],{"class":226},"|",[212,298,299],{"class":226}," {\n",[212,301,303,307,310,313,315,317,320,323,326,328,331,334],{"class":214,"line":302},3,[212,304,306],{"class":305},"s7zQu","    if",[212,308,309],{"class":218}," let",[212,311,312],{"class":282}," Some",[212,314,254],{"class":226},[212,316,246],{"class":222},[212,318,319],{"class":226},")",[212,321,322],{"class":226}," =",[212,324,325],{"class":222}," weak",[212,327,233],{"class":226},[212,329,330],{"class":236},"upgrade",[212,332,333],{"class":226},"()",[212,335,299],{"class":226},[212,337,339,342,345,347,349,351,354,356,358,361,363,365],{"class":214,"line":338},4,[212,340,341],{"class":218},"        let",[212,343,344],{"class":222}," _ ",[212,346,227],{"class":226},[212,348,230],{"class":222},[212,350,233],{"class":226},[212,352,353],{"class":236},"emit",[212,355,254],{"class":226},[212,357,257],{"class":226},[212,359,360],{"class":260},"pong",[212,362,257],{"class":226},[212,364,266],{"class":226},[212,366,367],{"class":226}," ());\n",[212,369,371],{"class":214,"line":370},5,[212,372,373],{"class":226},"    }\n",[212,375,377],{"class":214,"line":376},6,[212,378,379],{"class":226},"});\n",[203,381,383],{"className":205,"code":382,"language":207,"meta":208,"style":208},"use serde_json::json;\nuse socketio_next::{Client, Event};\n\nclient.on(\"question\", |event: Event, _: Client| {\n    let (text, n): (String, u32) = event.payload().deserialize().unwrap();\n    event.ack(json!({ \"answer\": n + 1 })).unwrap(); \u002F\u002F the server's callback\n});\nclient.once(\"ready\", |_: Event, _: Client| println!(\"ready\"));\nlet id = client.on_any(|event: Event, _: Client| println!(\"{}\", event.name()));\nclient.off_listener(id);\n",[144,384,385,402,421,427,467,521,570,575,628,683],{"__ignoreMap":208},[212,386,387,390,393,396,399],{"class":214,"line":215},[212,388,389],{"class":269},"use",[212,391,392],{"class":282}," serde_json",[212,394,395],{"class":226},"::",[212,397,398],{"class":282},"json",[212,400,401],{"class":226},";\n",[212,403,404,406,409,412,414,416,418],{"class":214,"line":243},[212,405,389],{"class":269},[212,407,408],{"class":282}," socketio_next",[212,410,411],{"class":226},"::{",[212,413,28],{"class":282},[212,415,266],{"class":226},[212,417,283],{"class":282},[212,419,420],{"class":226},"};\n",[212,422,423],{"class":214,"line":302},[212,424,426],{"emptyLinePlaceholder":425},true,"\n",[212,428,429,431,433,435,437,439,442,444,446,448,451,453,455,457,459,461,463,465],{"class":214,"line":338},[212,430,246],{"class":222},[212,432,233],{"class":226},[212,434,251],{"class":236},[212,436,254],{"class":226},[212,438,257],{"class":226},[212,440,441],{"class":260},"question",[212,443,257],{"class":226},[212,445,266],{"class":226},[212,447,273],{"class":226},[212,449,450],{"class":222},"event",[212,452,279],{"class":226},[212,454,283],{"class":282},[212,456,266],{"class":226},[212,458,288],{"class":222},[212,460,279],{"class":226},[212,462,293],{"class":282},[212,464,296],{"class":226},[212,466,299],{"class":226},[212,468,469,472,475,478,480,483,486,488,491,493,496,498,500,503,505,508,511,514,516,519],{"class":214,"line":370},[212,470,471],{"class":218},"    let",[212,473,474],{"class":226}," (",[212,476,477],{"class":222},"text",[212,479,266],{"class":226},[212,481,482],{"class":222}," n",[212,484,485],{"class":226},"):",[212,487,474],{"class":226},[212,489,490],{"class":282},"String",[212,492,266],{"class":226},[212,494,495],{"class":282}," u32",[212,497,319],{"class":226},[212,499,322],{"class":226},[212,501,502],{"class":222}," event",[212,504,233],{"class":226},[212,506,507],{"class":236},"payload",[212,509,510],{"class":226},"().",[212,512,513],{"class":236},"deserialize",[212,515,510],{"class":226},[212,517,518],{"class":236},"unwrap",[212,520,240],{"class":226},[212,522,523,526,528,531,533,536,539,542,545,547,549,552,555,558,561,563,566],{"class":214,"line":376},[212,524,525],{"class":222},"    event",[212,527,233],{"class":226},[212,529,530],{"class":236},"ack",[212,532,254],{"class":226},[212,534,535],{"class":236},"json!",[212,537,538],{"class":226},"({",[212,540,541],{"class":226}," \"",[212,543,544],{"class":260},"answer",[212,546,257],{"class":226},[212,548,279],{"class":226},[212,550,551],{"class":222}," n ",[212,553,554],{"class":226},"+",[212,556,557],{"class":269}," 1",[212,559,560],{"class":226}," })).",[212,562,518],{"class":236},[212,564,565],{"class":226},"();",[212,567,569],{"class":568},"sHwdD"," \u002F\u002F the server's callback\n",[212,571,573],{"class":214,"line":572},7,[212,574,379],{"class":226},[212,576,578,580,582,585,587,589,592,594,596,598,600,602,604,606,608,610,612,614,617,619,621,623,625],{"class":214,"line":577},8,[212,579,246],{"class":222},[212,581,233],{"class":226},[212,583,584],{"class":236},"once",[212,586,254],{"class":226},[212,588,257],{"class":226},[212,590,591],{"class":260},"ready",[212,593,257],{"class":226},[212,595,266],{"class":226},[212,597,273],{"class":226},[212,599,276],{"class":222},[212,601,279],{"class":226},[212,603,283],{"class":282},[212,605,266],{"class":226},[212,607,288],{"class":222},[212,609,279],{"class":226},[212,611,293],{"class":282},[212,613,296],{"class":226},[212,615,616],{"class":236}," println!",[212,618,254],{"class":226},[212,620,257],{"class":226},[212,622,591],{"class":260},[212,624,257],{"class":226},[212,626,627],{"class":226},"));\n",[212,629,631,633,636,638,640,642,645,648,650,652,654,656,658,660,662,664,666,668,671,673,675,677,680],{"class":214,"line":630},9,[212,632,219],{"class":218},[212,634,635],{"class":222}," id ",[212,637,227],{"class":226},[212,639,230],{"class":222},[212,641,233],{"class":226},[212,643,644],{"class":236},"on_any",[212,646,647],{"class":226},"(|",[212,649,450],{"class":222},[212,651,279],{"class":226},[212,653,283],{"class":282},[212,655,266],{"class":226},[212,657,288],{"class":222},[212,659,279],{"class":226},[212,661,293],{"class":282},[212,663,296],{"class":226},[212,665,616],{"class":236},[212,667,254],{"class":226},[212,669,670],{"class":226},"\"{}\"",[212,672,266],{"class":226},[212,674,502],{"class":222},[212,676,233],{"class":226},[212,678,679],{"class":236},"name",[212,681,682],{"class":226},"()));\n",[212,684,686,688,690,693,695,698],{"class":214,"line":685},10,[212,687,246],{"class":222},[212,689,233],{"class":226},[212,691,692],{"class":236},"off_listener",[212,694,254],{"class":226},[212,696,697],{"class":222},"id",[212,699,700],{"class":226},");\n",[702,703,704,717],"table",{},[705,706,707],"thead",{},[708,709,710,714],"tr",{},[711,712,713],"th",{},"Method",[711,715,716],{},"What",[718,719,720,737,750,763,777,787,800,810],"tbody",{},[708,721,722,728],{},[723,724,725],"td",{},[144,726,727],{},"on(event, handler)",[723,729,730,731,733,734],{},"handles ",[144,732,450],{},"; returns a ",[144,735,736],{},"ListenerId",[708,738,739,744],{},[723,740,741],{},[144,742,743],{},"once(event, handler)",[723,745,746,747,749],{},"handles the next ",[144,748,450],{}," only",[708,751,752,757],{},[723,753,754],{},[144,755,756],{},"on_any(handler)",[723,758,759,760,319],{},"every event, before the event's own handlers (",[144,761,762],{},"onAny",[708,764,765,770],{},[723,766,767],{},[144,768,769],{},"on_state_change(handler)",[723,771,772,773,776],{},"every ",[144,774,775],{},"ConnectionState"," transition, in order with the events",[708,778,779,784],{},[723,780,781],{},[144,782,783],{},"off(event)",[723,785,786],{},"removes the event's handlers; returns how many",[708,788,789,794],{},[723,790,791],{},[144,792,793],{},"off_any()",[723,795,796,797,799],{},"removes the ",[144,798,644],{}," handlers",[708,801,802,807],{},[723,803,804],{},[144,805,806],{},"off_listener(id)",[723,808,809],{},"removes one handler",[708,811,812,817],{},[723,813,814],{},[144,815,816],{},"listener_count(event)",[723,818,819,820],{},"handlers of ",[144,821,450],{},[140,823,824,825,827],{},"Handlers are matched by exact event name. Events with no handler are dropped (",[144,826,644],{}," sees them).",[135,829,831],{"id":830},"the-event","The event",[702,833,834,845],{},[705,835,836],{},[708,837,838,843],{},[711,839,840,842],{},[144,841,146],{}," method",[711,844,716],{},[718,846,847,857,873,887,897,907],{},[708,848,849,854],{},[723,850,851],{},[144,852,853],{},"name()",[723,855,856],{},"the event name",[708,858,859,868],{},[723,860,861,864,865],{},[144,862,863],{},"payload()"," \u002F ",[144,866,867],{},"into_payload()",[723,869,870,871],{},"the arguments as a ",[144,872,150],{},[708,874,875,880],{},[723,876,877],{},[144,878,879],{},"arg::\u003CT>(i)",[723,881,882,883,886],{},"argument ",[144,884,885],{},"i"," deserialized",[708,888,889,894],{},[723,890,891],{},[144,892,893],{},"wants_ack()",[723,895,896],{},"the server passed a callback",[708,898,899,904],{},[723,900,901],{},[144,902,903],{},"ack(data)",[723,905,906],{},"answers the callback; sent at most once, later calls are ignored",[708,908,909,914],{},[723,910,911],{},[144,912,913],{},"ack_sender()",[723,915,916,917,920],{},"an ",[144,918,919],{},"AckSender"," to answer later, from another task",[135,922,923],{"id":353},"Emit",[203,925,927],{"className":205,"code":926,"language":207,"meta":208,"style":208},"client.emit(\"chat\", \"hello\")?;                         \u002F\u002F one string argument\nclient.emit(\"move\", vec![json!(1), json!(2)])?;        \u002F\u002F two arguments\nclient.emit(\"ping\", ())?;                              \u002F\u002F no arguments\nclient.emit(\"user\", Payload::serialize(&user)?)?;      \u002F\u002F any Serialize\n",[144,928,929,961,1010,1034],{"__ignoreMap":208},[212,930,931,933,935,937,939,941,944,946,948,950,953,955,958],{"class":214,"line":215},[212,932,246],{"class":222},[212,934,233],{"class":226},[212,936,353],{"class":236},[212,938,254],{"class":226},[212,940,257],{"class":226},[212,942,943],{"class":260},"chat",[212,945,257],{"class":226},[212,947,266],{"class":226},[212,949,541],{"class":226},[212,951,952],{"class":260},"hello",[212,954,257],{"class":226},[212,956,957],{"class":226},")?;",[212,959,960],{"class":568},"                         \u002F\u002F one string argument\n",[212,962,963,965,967,969,971,973,976,978,980,983,986,988,990,993,996,999,1001,1004,1007],{"class":214,"line":243},[212,964,246],{"class":222},[212,966,233],{"class":226},[212,968,353],{"class":236},[212,970,254],{"class":226},[212,972,257],{"class":226},[212,974,975],{"class":260},"move",[212,977,257],{"class":226},[212,979,266],{"class":226},[212,981,982],{"class":236}," vec!",[212,984,985],{"class":226},"[",[212,987,535],{"class":236},[212,989,254],{"class":226},[212,991,992],{"class":269},"1",[212,994,995],{"class":226},"),",[212,997,998],{"class":236}," json!",[212,1000,254],{"class":226},[212,1002,1003],{"class":269},"2",[212,1005,1006],{"class":226},")])?;",[212,1008,1009],{"class":568},"        \u002F\u002F two arguments\n",[212,1011,1012,1014,1016,1018,1020,1022,1024,1026,1028,1031],{"class":214,"line":302},[212,1013,246],{"class":222},[212,1015,233],{"class":226},[212,1017,353],{"class":236},[212,1019,254],{"class":226},[212,1021,257],{"class":226},[212,1023,261],{"class":260},[212,1025,257],{"class":226},[212,1027,266],{"class":226},[212,1029,1030],{"class":226}," ())?;",[212,1032,1033],{"class":568},"                              \u002F\u002F no arguments\n",[212,1035,1036,1038,1040,1042,1044,1046,1049,1051,1053,1056,1058,1061,1064,1066,1069],{"class":214,"line":338},[212,1037,246],{"class":222},[212,1039,233],{"class":226},[212,1041,353],{"class":236},[212,1043,254],{"class":226},[212,1045,257],{"class":226},[212,1047,1048],{"class":260},"user",[212,1050,257],{"class":226},[212,1052,266],{"class":226},[212,1054,1055],{"class":282}," Payload",[212,1057,395],{"class":226},[212,1059,1060],{"class":236},"serialize",[212,1062,1063],{"class":226},"(&",[212,1065,1048],{"class":222},[212,1067,1068],{"class":226},")?)?;",[212,1070,1071],{"class":568},"      \u002F\u002F any Serialize\n",[140,1073,1074,1076,1077,1080,1081,1088,1089,1092,1093,1092,1096,1099,1100,233],{},[144,1075,353],{}," never blocks: it queues the packet for the connection task and returns. Offline it fails with ",[144,1078,1079],{},"Error::NotConnected",", or queues with ",[1082,1083,1085],"a",{"href":1084},"\u002Fclient\u002Fconfiguration#offline-emits",[144,1086,1087],{},"buffer_while_disconnected",". Reserved names (",[144,1090,1091],{},"connect",", ",[144,1094,1095],{},"connect_error",[144,1097,1098],{},"disconnect",", ...) fail with ",[144,1101,1102],{},"ReservedEvent",[140,1104,1105,1108,1109,1112,1113,1116,1117,1120,1121,1123,1124,864,1127,1130,1131,233],{},[144,1106,1107],{},"data"," is anything ",[144,1110,1111],{},"Into\u003CPayload>",": a ",[144,1114,1115],{},"serde_json::Value",", a ",[144,1118,1119],{},"Vec\u003CValue>"," (several arguments), a string, a number, ",[144,1122,333],{}," (no arguments), ",[144,1125,1126],{},"Bytes",[144,1128,1129],{},"Vec\u003Cu8>",", or ",[144,1132,1133],{},"Payload::serialize(&your_struct)?",[135,1135,1137],{"id":1136},"acks-from-the-server","Acks from the server",[203,1139,1141],{"className":205,"code":1140,"language":207,"meta":208,"style":208},"use std::time::Duration;\n\nlet reply = client\n    .emit_with_ack(\"add\", vec![json!(1), json!(2)], Duration::from_secs(5))\n    .await?;\nlet sum: i64 = reply.arg(0)?;\n",[144,1142,1143,1162,1166,1178,1234,1244],{"__ignoreMap":208},[212,1144,1145,1147,1150,1152,1155,1157,1160],{"class":214,"line":215},[212,1146,389],{"class":269},[212,1148,1149],{"class":282}," std",[212,1151,395],{"class":226},[212,1153,1154],{"class":282},"time",[212,1156,395],{"class":226},[212,1158,1159],{"class":282},"Duration",[212,1161,401],{"class":226},[212,1163,1164],{"class":214,"line":243},[212,1165,426],{"emptyLinePlaceholder":425},[212,1167,1168,1170,1173,1175],{"class":214,"line":302},[212,1169,219],{"class":218},[212,1171,1172],{"class":222}," reply ",[212,1174,227],{"class":226},[212,1176,1177],{"class":222}," client\n",[212,1179,1180,1183,1186,1188,1190,1193,1195,1197,1199,1201,1203,1205,1207,1209,1211,1213,1215,1218,1221,1223,1226,1228,1231],{"class":214,"line":338},[212,1181,1182],{"class":226},"    .",[212,1184,1185],{"class":236},"emit_with_ack",[212,1187,254],{"class":226},[212,1189,257],{"class":226},[212,1191,1192],{"class":260},"add",[212,1194,257],{"class":226},[212,1196,266],{"class":226},[212,1198,982],{"class":236},[212,1200,985],{"class":226},[212,1202,535],{"class":236},[212,1204,254],{"class":226},[212,1206,992],{"class":269},[212,1208,995],{"class":226},[212,1210,998],{"class":236},[212,1212,254],{"class":226},[212,1214,1003],{"class":269},[212,1216,1217],{"class":226},")],",[212,1219,1220],{"class":282}," Duration",[212,1222,395],{"class":226},[212,1224,1225],{"class":236},"from_secs",[212,1227,254],{"class":226},[212,1229,1230],{"class":269},"5",[212,1232,1233],{"class":226},"))\n",[212,1235,1236,1238,1241],{"class":214,"line":370},[212,1237,1182],{"class":226},[212,1239,1240],{"class":305},"await",[212,1242,1243],{"class":226},"?;\n",[212,1245,1246,1248,1251,1253,1256,1258,1261,1263,1266,1268,1271],{"class":214,"line":376},[212,1247,219],{"class":218},[212,1249,1250],{"class":222}," sum",[212,1252,279],{"class":226},[212,1254,1255],{"class":282}," i64",[212,1257,322],{"class":226},[212,1259,1260],{"class":222}," reply",[212,1262,233],{"class":226},[212,1264,1265],{"class":236},"arg",[212,1267,254],{"class":226},[212,1269,1270],{"class":269},"0",[212,1272,1273],{"class":226},")?;\n",[140,1275,1276,1279,1280,1282,1283,1286,1287,1290],{},[144,1277,1278],{},"emit_with_ack(event, data, timeout).await"," returns the ack's arguments as a ",[144,1281,150],{},", or fails with ",[144,1284,1285],{},"AckTimeout"," when no answer came in time, ",[144,1288,1289],{},"Disconnected"," when the connection was lost first. Ack ids are unique per client.",[135,1292,1294],{"id":1293},"acks-to-the-server","Acks to the server",[140,1296,1297,1298,1301,1302,1305,1306,1309,1310,1313],{},"When the server emits with a callback (",[144,1299,1300],{},"socket.emit(\"question\", \"?\", (answer) => ...)","), ",[144,1303,1304],{},"event.wants_ack()"," is true and ",[144,1307,1308],{},"event.ack(data)"," answers it, as ACK or BINARY_ACK. ",[144,1311,1312],{},"event.ack_sender()"," returns a handle to answer later.",[135,1315,150],{"id":507},[203,1317,1319],{"className":205,"code":1318,"language":207,"meta":208,"style":208},"pub enum Payload {\n    Text(Vec\u003CValue>),                      \u002F\u002F JSON arguments\n    Binary(Bytes),                         \u002F\u002F one lone buffer\n    Mixed { args: Vec\u003CValue>, attachments: Vec\u003CBytes> },\n}\n",[144,1320,1321,1333,1355,1369,1409],{"__ignoreMap":208},[212,1322,1323,1326,1329,1331],{"class":214,"line":215},[212,1324,1325],{"class":218},"pub",[212,1327,1328],{"class":218}," enum",[212,1330,1055],{"class":282},[212,1332,299],{"class":226},[212,1334,1335,1338,1340,1343,1346,1349,1352],{"class":214,"line":243},[212,1336,1337],{"class":236},"    Text",[212,1339,254],{"class":226},[212,1341,1342],{"class":282},"Vec",[212,1344,1345],{"class":226},"\u003C",[212,1347,1348],{"class":282},"Value",[212,1350,1351],{"class":226},">),",[212,1353,1354],{"class":568},"                      \u002F\u002F JSON arguments\n",[212,1356,1357,1360,1362,1364,1366],{"class":214,"line":302},[212,1358,1359],{"class":236},"    Binary",[212,1361,254],{"class":226},[212,1363,1126],{"class":282},[212,1365,995],{"class":226},[212,1367,1368],{"class":568},"                         \u002F\u002F one lone buffer\n",[212,1370,1371,1374,1377,1380,1382,1385,1387,1389,1392,1395,1397,1399,1401,1403,1406],{"class":214,"line":338},[212,1372,1373],{"class":282},"    Mixed",[212,1375,1376],{"class":226}," {",[212,1378,1379],{"class":222}," args",[212,1381,279],{"class":226},[212,1383,1384],{"class":282}," Vec",[212,1386,1345],{"class":226},[212,1388,1348],{"class":282},[212,1390,1391],{"class":226},">,",[212,1393,1394],{"class":222}," attachments",[212,1396,279],{"class":226},[212,1398,1384],{"class":282},[212,1400,1345],{"class":226},[212,1402,1126],{"class":282},[212,1404,1405],{"class":226},">",[212,1407,1408],{"class":226}," },\n",[212,1410,1411],{"class":214,"line":370},[212,1412,1413],{"class":226},"}\n",[140,1415,1416,1092,1419,1092,1422,1092,1425,1428,1429,1092,1432,233],{},[144,1417,1418],{},"payload.args()",[144,1420,1421],{},"payload.binary()",[144,1423,1424],{},"payload.arg::\u003CT>(i)",[144,1426,1427],{},"payload.deserialize::\u003CT>()"," (all arguments as a tuple or struct), ",[144,1430,1431],{},"len()",[144,1433,1434],{},"is_empty()",[135,1436,1438],{"id":1437},"binary","Binary",[140,1440,1441,1442,1445,1446,1449,1450,1453,1454,1457,1458,1461,1462,1465],{},"A lone buffer arrives as ",[144,1443,1444],{},"Payload::Binary",". Buffers anywhere else (several, next to JSON, inside objects) arrive as ",[144,1447,1448],{},"Payload::Mixed { args, attachments }",", where ",[144,1451,1452],{},"{\"_placeholder\":true,\"num\":n}"," in ",[144,1455,1456],{},"args"," stands for ",[144,1459,1460],{},"attachments[n]",": the socket.io wire format. Send the same shapes; ",[144,1463,1464],{},"Payload::placeholder(n)"," builds a placeholder.",[203,1467,1469],{"className":205,"code":1468,"language":207,"meta":208,"style":208},"use bytes::Bytes;\nuse socketio_next::Payload;\n\nclient.emit(\"upload\", Payload::Mixed {\n    args: vec![json!({ \"name\": \"a.bin\", \"data\": Payload::placeholder(0) })],\n    attachments: vec![Bytes::from_static(b\"\\x00\\x01\\x02\")],\n})?;\n",[144,1470,1471,1484,1496,1500,1528,1584,1617],{"__ignoreMap":208},[212,1472,1473,1475,1478,1480,1482],{"class":214,"line":215},[212,1474,389],{"class":269},[212,1476,1477],{"class":282}," bytes",[212,1479,395],{"class":226},[212,1481,1126],{"class":282},[212,1483,401],{"class":226},[212,1485,1486,1488,1490,1492,1494],{"class":214,"line":243},[212,1487,389],{"class":269},[212,1489,408],{"class":282},[212,1491,395],{"class":226},[212,1493,150],{"class":282},[212,1495,401],{"class":226},[212,1497,1498],{"class":214,"line":302},[212,1499,426],{"emptyLinePlaceholder":425},[212,1501,1502,1504,1506,1508,1510,1512,1515,1517,1519,1521,1523,1526],{"class":214,"line":338},[212,1503,246],{"class":222},[212,1505,233],{"class":226},[212,1507,353],{"class":236},[212,1509,254],{"class":226},[212,1511,257],{"class":226},[212,1513,1514],{"class":260},"upload",[212,1516,257],{"class":226},[212,1518,266],{"class":226},[212,1520,1055],{"class":282},[212,1522,395],{"class":226},[212,1524,1525],{"class":282},"Mixed",[212,1527,299],{"class":226},[212,1529,1530,1533,1535,1537,1539,1541,1543,1545,1547,1549,1551,1553,1556,1558,1560,1562,1564,1566,1568,1570,1572,1575,1577,1579,1581],{"class":214,"line":370},[212,1531,1532],{"class":222},"    args",[212,1534,279],{"class":226},[212,1536,982],{"class":236},[212,1538,985],{"class":226},[212,1540,535],{"class":236},[212,1542,538],{"class":226},[212,1544,541],{"class":226},[212,1546,679],{"class":260},[212,1548,257],{"class":226},[212,1550,279],{"class":226},[212,1552,541],{"class":226},[212,1554,1555],{"class":260},"a.bin",[212,1557,257],{"class":226},[212,1559,266],{"class":226},[212,1561,541],{"class":226},[212,1563,1107],{"class":260},[212,1565,257],{"class":226},[212,1567,279],{"class":226},[212,1569,1055],{"class":282},[212,1571,395],{"class":226},[212,1573,1574],{"class":236},"placeholder",[212,1576,254],{"class":226},[212,1578,1270],{"class":269},[212,1580,319],{"class":226},[212,1582,1583],{"class":226}," })],\n",[212,1585,1586,1589,1591,1593,1595,1597,1599,1602,1604,1607,1609,1612,1614],{"class":214,"line":376},[212,1587,1588],{"class":222},"    attachments",[212,1590,279],{"class":226},[212,1592,982],{"class":236},[212,1594,985],{"class":226},[212,1596,1126],{"class":282},[212,1598,395],{"class":226},[212,1600,1601],{"class":236},"from_static",[212,1603,254],{"class":226},[212,1605,1606],{"class":260},"b",[212,1608,257],{"class":226},[212,1610,1611],{"class":222},"\\x00\\x01\\x02",[212,1613,257],{"class":226},[212,1615,1616],{"class":226},")],\n",[212,1618,1619],{"class":214,"line":572},[212,1620,1621],{"class":226},"})?;\n",[1623,1624,1625],"style",{},"html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}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);}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}",{"title":208,"searchDepth":243,"depth":302,"links":1627},[1628,1629,1630,1631,1632,1633,1634],{"id":137,"depth":243,"text":138},{"id":830,"depth":243,"text":831},{"id":353,"depth":243,"text":923},{"id":1136,"depth":243,"text":1137},{"id":1293,"depth":243,"text":1294},{"id":507,"depth":243,"text":150},{"id":1437,"depth":243,"text":1438},"Handlers, emit, acks in both directions, payloads and binary data.","md",null,{},{"title":38,"description":1635},"xrMfJDrvuqfBVPhBesvOwAQbjt5IZ-r99Uo4j4HDfE4",[1642,1644],{"title":34,"path":35,"stem":36,"description":1643,"children":-1},"Every ClientBuilder option, with its socket.io-client counterpart and default.",{"title":42,"path":43,"stem":44,"description":1645,"children":-1},"ConnectionState, DisconnectReason, LinkInfo, the heartbeat, reconnect() and shutdown.",1795285663245]