[{"data":1,"prerenderedAt":1674},["ShallowReactive",2],{"navigation_docs":3,"-projects-concurrent-url-checker-cancellation-and-tests":377,"-projects-concurrent-url-checker-cancellation-and-tests-surround":1669},[4,39,114,144,184,244,293,362],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":6},"Getting Started",false,"\u002Fgetting-started","1.getting-started",[10,15,20,25,30,35],{"title":11,"path":12,"stem":13,"icon":14},"Learning Path","\u002Fgetting-started\u002Flearning-path","1.getting-started\u002F1.learning-path","i-lucide-map",{"title":16,"path":17,"stem":18,"icon":19},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F2.introduction","i-lucide-house",{"title":21,"path":22,"stem":23,"icon":24},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F3.installation","i-lucide-download",{"title":26,"path":27,"stem":28,"icon":29},"Your First Program","\u002Fgetting-started\u002Ffirst-program","1.getting-started\u002F4.first-program","i-lucide-play",{"title":31,"path":32,"stem":33,"icon":34},"Modules and Dependencies","\u002Fgetting-started\u002Fmodules-and-dependencies","1.getting-started\u002F5.modules-and-dependencies","i-lucide-package-open",{"title":36,"path":37,"stem":38,"icon":34},"Advanced Modules","\u002Fgetting-started\u002Fadvanced-modules","1.getting-started\u002F6.advanced-modules",{"title":40,"path":41,"stem":42,"children":43,"page":6},"Fundamentals","\u002Ffundamentals","2.fundamentals",[44,49,54,59,64,69,74,79,84,89,94,99,104,109],{"title":45,"path":46,"stem":47,"icon":48},"Program Structure","\u002Ffundamentals\u002Fprogram-structure","2.fundamentals\u002F1.program-structure","i-lucide-workflow",{"title":50,"path":51,"stem":52,"icon":53},"Structs and Methods","\u002Ffundamentals\u002Fstructs-and-methods","2.fundamentals\u002F10.structs-and-methods","i-lucide-box",{"title":55,"path":56,"stem":57,"icon":58},"Interfaces","\u002Ffundamentals\u002Finterfaces","2.fundamentals\u002F11.interfaces","i-lucide-plug",{"title":60,"path":61,"stem":62,"icon":63},"Error Handling","\u002Ffundamentals\u002Ferrors","2.fundamentals\u002F12.errors","i-lucide-triangle-alert",{"title":65,"path":66,"stem":67,"icon":68},"Defined Types and Type Aliases","\u002Ffundamentals\u002Fdefined-types","2.fundamentals\u002F13.defined-types","i-lucide-tags",{"title":70,"path":71,"stem":72,"icon":73},"Generics","\u002Ffundamentals\u002Fgenerics","2.fundamentals\u002F14.generics","i-lucide-blocks",{"title":75,"path":76,"stem":77,"icon":78},"Project Structure","\u002Ffundamentals\u002Fproject-structure","2.fundamentals\u002F2.project-structure","i-lucide-folder-tree",{"title":80,"path":81,"stem":82,"icon":83},"Project Layout","\u002Ffundamentals\u002Fproject-layout","2.fundamentals\u002F3.project-layout","i-lucide-layout",{"title":85,"path":86,"stem":87,"icon":88},"Variables and Data Types","\u002Ffundamentals\u002Fvariables-and-types","2.fundamentals\u002F4.variables-and-types","i-lucide-variable",{"title":90,"path":91,"stem":92,"icon":93},"Functions","\u002Ffundamentals\u002Ffunctions","2.fundamentals\u002F5.functions","i-lucide-braces",{"title":95,"path":96,"stem":97,"icon":98},"Control Statements","\u002Ffundamentals\u002Fcontrol-statements","2.fundamentals\u002F6.control-statements","i-lucide-git-branch",{"title":100,"path":101,"stem":102,"icon":103},"Pointers","\u002Ffundamentals\u002Fpointers","2.fundamentals\u002F7.pointers","i-lucide-mouse-pointer-2",{"title":105,"path":106,"stem":107,"icon":108},"Arrays and Slices","\u002Ffundamentals\u002Farrays-and-slices","2.fundamentals\u002F8.arrays-and-slices","i-lucide-list",{"title":110,"path":111,"stem":112,"icon":113},"Maps","\u002Ffundamentals\u002Fmaps","2.fundamentals\u002F9.maps","i-lucide-table-properties",{"title":115,"path":116,"stem":117,"children":118,"page":6},"Concurrency","\u002Fconcurrency","3.concurrency",[119,124,129,134,139],{"title":120,"path":121,"stem":122,"icon":123},"Concurrency Model","\u002Fconcurrency\u002Fconcurrency-model","3.concurrency\u002F1.concurrency-model","i-lucide-network",{"title":125,"path":126,"stem":127,"icon":128},"Goroutines","\u002Fconcurrency\u002Fgoroutines","3.concurrency\u002F2.goroutines","i-lucide-git-fork",{"title":130,"path":131,"stem":132,"icon":133},"Channels","\u002Fconcurrency\u002Fchannels","3.concurrency\u002F3.channels","i-lucide-arrow-left-right",{"title":135,"path":136,"stem":137,"icon":138},"Select and Cancellation","\u002Fconcurrency\u002Fselect-and-cancellation","3.concurrency\u002F4.select-and-cancellation","i-lucide-circle-stop",{"title":140,"path":141,"stem":142,"icon":143},"Synchronization","\u002Fconcurrency\u002Fsynchronization","3.concurrency\u002F5.synchronization","i-lucide-lock-keyhole",{"title":145,"path":146,"stem":147,"children":148,"page":6},"Standard Library","\u002Fstandard-library","4.standard-library",[149,154,159,164,169,174,179],{"title":150,"path":151,"stem":152,"icon":153},"Standard Library Overview","\u002Fstandard-library\u002Foverview","4.standard-library\u002F1.overview","i-lucide-library",{"title":155,"path":156,"stem":157,"icon":158},"Text and Formatting","\u002Fstandard-library\u002Ftext-and-formatting","4.standard-library\u002F2.text-and-formatting","i-lucide-text",{"title":160,"path":161,"stem":162,"icon":163},"Files and JSON","\u002Fstandard-library\u002Ffiles-and-json","4.standard-library\u002F3.files-and-json","i-lucide-file-json",{"title":165,"path":166,"stem":167,"icon":168},"HTTP Clients and Servers","\u002Fstandard-library\u002Fhttp","4.standard-library\u002F4.http","i-lucide-server",{"title":170,"path":171,"stem":172,"icon":173},"Testing","\u002Fstandard-library\u002Ftesting","4.standard-library\u002F5.testing","i-lucide-flask-conical",{"title":175,"path":176,"stem":177,"icon":178},"Command-Line Tools and Configuration","\u002Fstandard-library\u002Fcommand-line-and-configuration","4.standard-library\u002F6.command-line-and-configuration","i-lucide-terminal-square",{"title":180,"path":181,"stem":182,"icon":183},"Structured Logging","\u002Fstandard-library\u002Fstructured-logging","4.standard-library\u002F7.structured-logging","i-lucide-scroll-text",{"title":185,"path":186,"stem":187,"children":188,"page":6},"Backend Development","\u002Fbackend-development","5.backend-development",[189,194,199,204,209,214,219,224,229,234,239],{"title":190,"path":191,"stem":192,"icon":193},"Backend Roadmap","\u002Fbackend-development\u002Fbackend-roadmap","5.backend-development\u002F1.backend-roadmap","i-lucide-route",{"title":195,"path":196,"stem":197,"icon":198},"Graceful Shutdown","\u002Fbackend-development\u002Fgraceful-shutdown","5.backend-development\u002F10.graceful-shutdown","i-lucide-power",{"title":200,"path":201,"stem":202,"icon":203},"Production Checklist","\u002Fbackend-development\u002Fproduction-checklist","5.backend-development\u002F11.production-checklist","i-lucide-clipboard-check",{"title":205,"path":206,"stem":207,"icon":208},"HTTP API Design","\u002Fbackend-development\u002Fhttp-api-design","5.backend-development\u002F2.http-api-design","i-lucide-waypoints",{"title":210,"path":211,"stem":212,"icon":213},"Middleware","\u002Fbackend-development\u002Fmiddleware","5.backend-development\u002F3.middleware","i-lucide-layers-3",{"title":215,"path":216,"stem":217,"icon":218},"Validation","\u002Fbackend-development\u002Fvalidation","5.backend-development\u002F4.validation","i-lucide-list-checks",{"title":220,"path":221,"stem":222,"icon":223},"Application Wiring","\u002Fbackend-development\u002Fapplication-wiring","5.backend-development\u002F5.application-wiring","i-lucide-cable",{"title":225,"path":226,"stem":227,"icon":228},"Observability","\u002Fbackend-development\u002Fobservability","5.backend-development\u002F6.observability","i-lucide-activity",{"title":230,"path":231,"stem":232,"icon":233},"Database SQL","\u002Fbackend-development\u002Fdatabase-sql","5.backend-development\u002F7.database-sql","i-lucide-database",{"title":235,"path":236,"stem":237,"icon":238},"Transactions","\u002Fbackend-development\u002Ftransactions","5.backend-development\u002F8.transactions","i-lucide-repeat-2",{"title":240,"path":241,"stem":242,"icon":243},"Authentication and Authorization","\u002Fbackend-development\u002Fauthentication","5.backend-development\u002F9.authentication","i-lucide-shield-check",{"title":245,"path":246,"stem":247,"children":248,"page":6},"Advanced Go","\u002Fadvanced-go","6.advanced-go",[249,254,259,264,269,274,278,283,288],{"title":250,"path":251,"stem":252,"icon":253},"Advanced Go Roadmap","\u002Fadvanced-go\u002Fadvanced-roadmap","6.advanced-go\u002F1.advanced-roadmap","i-lucide-brain-circuit",{"title":255,"path":256,"stem":257,"icon":258},"Reflection","\u002Fadvanced-go\u002Freflection","6.advanced-go\u002F2.reflection","i-lucide-scan-search",{"title":260,"path":261,"stem":262,"icon":263},"Memory and Garbage Collection","\u002Fadvanced-go\u002Fmemory-and-garbage-collection","6.advanced-go\u002F3.memory-and-garbage-collection","i-lucide-memory-stick",{"title":265,"path":266,"stem":267,"icon":268},"Benchmarking and Profiling","\u002Fadvanced-go\u002Fbenchmarking-and-profiling","6.advanced-go\u002F4.benchmarking-and-profiling","i-lucide-gauge",{"title":270,"path":271,"stem":272,"icon":273},"Advanced Testing and Fuzzing","\u002Fadvanced-go\u002Fadvanced-testing-and-fuzzing","6.advanced-go\u002F5.advanced-testing-and-fuzzing","i-lucide-microscope",{"title":275,"path":276,"stem":277,"icon":48},"Advanced Concurrency","\u002Fadvanced-go\u002Fadvanced-concurrency","6.advanced-go\u002F6.advanced-concurrency",{"title":279,"path":280,"stem":281,"icon":282},"Unsafe and C Boundaries","\u002Fadvanced-go\u002Funsafe-and-cgo","6.advanced-go\u002F7.unsafe-and-cgo","i-lucide-radiation",{"title":284,"path":285,"stem":286,"icon":287},"Package and API Design","\u002Fadvanced-go\u002Fpackage-and-api-design","6.advanced-go\u002F8.package-and-api-design","i-lucide-boxes",{"title":289,"path":290,"stem":291,"icon":292},"Distributed Reliability","\u002Fadvanced-go\u002Fdistributed-reliability","6.advanced-go\u002F9.distributed-reliability","i-lucide-cloud-cog",{"title":294,"path":295,"stem":296,"children":297,"page":6},"Projects","\u002Fprojects","7.projects",[298,316,332,347],{"title":299,"path":300,"stem":301,"children":302,"icon":305},"CLI Task Manager","\u002Fprojects\u002Fcli-task-manager","7.projects\u002F1.cli-task-manager\u002Findex",[303,306,311],{"title":304,"path":300,"stem":301,"icon":305},"Project — CLI Task Manager","i-lucide-list-todo",{"title":307,"path":308,"stem":309,"icon":310},"CLI — Domain and Storage","\u002Fprojects\u002Fcli-task-manager\u002Fdomain-and-storage","7.projects\u002F1.cli-task-manager\u002F1.domain-and-storage","i-lucide-save",{"title":312,"path":313,"stem":314,"icon":315},"CLI — Commands and Tests","\u002Fprojects\u002Fcli-task-manager\u002Fcommands-and-tests","7.projects\u002F1.cli-task-manager\u002F2.commands-and-tests","i-lucide-terminal",{"title":317,"path":318,"stem":319,"children":320,"icon":323},"Concurrent URL Checker","\u002Fprojects\u002Fconcurrent-url-checker","7.projects\u002F2.concurrent-url-checker\u002Findex",[321,324,328],{"title":322,"path":318,"stem":319,"icon":323},"Project — Concurrent URL Checker","i-lucide-radar",{"title":325,"path":326,"stem":327,"icon":128},"URL Checker — Worker Pipeline","\u002Fprojects\u002Fconcurrent-url-checker\u002Fworker-pipeline","7.projects\u002F2.concurrent-url-checker\u002F1.worker-pipeline",{"title":329,"path":330,"stem":331,"icon":173},"URL Checker — Cancellation and Tests","\u002Fprojects\u002Fconcurrent-url-checker\u002Fcancellation-and-tests","7.projects\u002F2.concurrent-url-checker\u002F2.cancellation-and-tests",{"title":333,"path":334,"stem":335,"children":336},"File-backed API","\u002Fprojects\u002Ffile-backed-api","7.projects\u002F3.file-backed-api\u002Findex",[337,339,343],{"title":338,"path":334,"stem":335},"File-backed notes API",{"title":340,"path":341,"stem":342},"File store and concurrency","\u002Fprojects\u002Ffile-backed-api\u002Ffile-store-and-concurrency","7.projects\u002F3.file-backed-api\u002F1.file-store-and-concurrency",{"title":344,"path":345,"stem":346},"HTTP layer and tests","\u002Fprojects\u002Ffile-backed-api\u002Fhttp-and-tests","7.projects\u002F3.file-backed-api\u002F2.http-and-tests",{"title":348,"path":349,"stem":350,"children":351},"Production REST API","\u002Fprojects\u002Fproduction-rest-api","7.projects\u002F4.production-rest-api\u002Findex",[352,354,358],{"title":353,"path":349,"stem":350},"Production REST API capstone",{"title":355,"path":356,"stem":357},"Persistence and authentication","\u002Fprojects\u002Fproduction-rest-api\u002Fpersistence-and-auth","7.projects\u002F4.production-rest-api\u002F1.persistence-and-auth",{"title":359,"path":360,"stem":361},"Operations and release","\u002Fprojects\u002Fproduction-rest-api\u002Foperations-and-release","7.projects\u002F4.production-rest-api\u002F2.operations-and-release",{"title":363,"path":364,"stem":365,"children":366,"page":6},"Meta","\u002Fmeta","99.meta",[367,372],{"title":368,"path":369,"stem":370,"icon":371},"About","\u002Fmeta\u002Fabout","99.meta\u002F1.about","i-lucide-info",{"title":373,"path":374,"stem":375,"icon":376},"Acknowledgements","\u002Fmeta\u002Facknowledgements","99.meta\u002F2.acknowledgements","i-lucide-heart-handshake",{"id":378,"title":329,"body":379,"description":1661,"extension":1662,"links":1663,"meta":1664,"navigation":1665,"path":330,"seo":1666,"stem":331,"__hash__":1668},"docs\u002F7.projects\u002F2.concurrent-url-checker\u002F2.cancellation-and-tests.md",{"type":380,"value":381,"toc":1647},"minimark",[382,388,393,397,416,424,562,565,569,572,748,761,768,772,1035,1042,1046,1171,1185,1188,1192,1213,1216,1220,1230,1344,1355,1359,1362,1387,1390,1393,1397,1426,1430,1433,1614,1618,1635,1638,1643],[383,384],"learning-lesson-meta",{"level":385,"prerequisites":386,"time":387},"Intermediate","URL Checker Worker Pipeline and Go testing","75–100 minutes",[389,390,392],"h2",{"id":391},"what-you-will-learn","What you will learn",[394,395,396],"p",{},"By the end of this checkpoint, you will be able to:",[398,399,400,404,407,410,413],"ul",{},[401,402,403],"li",{},"test network behaviour with local controlled servers;",[401,405,406],{},"measure maximum in-flight requests safely;",[401,408,409],{},"coordinate cancellation tests without arbitrary sleeps;",[401,411,412],{},"verify deterministic ordering despite out-of-order completion;",[401,414,415],{},"use the race detector and goroutine checks responsibly.",[389,417,419,420],{"id":418},"use-httptestserver","Use ",[421,422,423],"code",{},"httptest.Server",[425,426,431],"pre",{"className":427,"code":428,"language":429,"meta":430,"style":430},"language-go shiki shiki-themes solarized-light material-theme one-dark-pro","server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n    w.WriteHeader(http.StatusNoContent)\n}))\nt.Cleanup(server.Close)\n","go","",[421,432,433,511,534,540],{"__ignoreMap":430},[434,435,438,442,446,449,453,457,460,463,465,468,470,474,476,480,484,486,489,492,495,498,500,502,505,508],"span",{"class":436,"line":437},"line",1,[434,439,441],{"class":440},"s45-6","server",[434,443,445],{"class":444},"su2KV"," :=",[434,447,448],{"class":440}," httptest",[434,450,452],{"class":451},"shFME",".",[434,454,456],{"class":455},"sisdC","NewServer",[434,458,459],{"class":451},"(",[434,461,462],{"class":440},"http",[434,464,452],{"class":451},[434,466,467],{"class":455},"HandlerFunc",[434,469,459],{"class":451},[434,471,473],{"class":472},"sEOdo","func",[434,475,459],{"class":451},[434,477,479],{"class":478},"syre3","w",[434,481,483],{"class":482},"snwKR"," http",[434,485,452],{"class":451},[434,487,488],{"class":482},"ResponseWriter",[434,490,491],{"class":451},",",[434,493,494],{"class":478}," r",[434,496,497],{"class":472}," *",[434,499,462],{"class":482},[434,501,452],{"class":451},[434,503,504],{"class":482},"Request",[434,506,507],{"class":451},")",[434,509,510],{"class":451}," {\n",[434,512,514,517,519,522,524,526,528,531],{"class":436,"line":513},2,[434,515,516],{"class":440},"    w",[434,518,452],{"class":451},[434,520,521],{"class":455},"WriteHeader",[434,523,459],{"class":451},[434,525,462],{"class":440},[434,527,452],{"class":451},[434,529,530],{"class":440},"StatusNoContent",[434,532,533],{"class":451},")\n",[434,535,537],{"class":436,"line":536},3,[434,538,539],{"class":451},"}))\n",[434,541,543,546,548,551,553,555,557,560],{"class":436,"line":542},4,[434,544,545],{"class":440},"t",[434,547,452],{"class":451},[434,549,550],{"class":455},"Cleanup",[434,552,459],{"class":451},[434,554,441],{"class":440},[434,556,452],{"class":451},[434,558,559],{"class":440},"Close",[434,561,533],{"class":451},[394,563,564],{},"The server provides a local URL and real HTTP transport behaviour without relying on the public internet.",[389,566,568],{"id":567},"test-output-ordering","Test output ordering",[394,570,571],{},"Create paths controlled by channels:",[425,573,575],{"className":427,"code":574,"language":429,"meta":430,"style":430},"releaseFirst := make(chan struct{})\n\nserver := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n    if r.URL.Path == \"\u002Ffirst\" {\n        \u003C-releaseFirst\n    }\n    w.WriteHeader(http.StatusOK)\n}))\nt.Cleanup(server.Close)\n",[421,576,577,598,604,654,689,698,704,724,729],{"__ignoreMap":430},[434,578,579,582,584,587,589,592,595],{"class":436,"line":437},[434,580,581],{"class":440},"releaseFirst",[434,583,445],{"class":444},[434,585,586],{"class":455}," make",[434,588,459],{"class":451},[434,590,591],{"class":472},"chan",[434,593,594],{"class":472}," struct",[434,596,597],{"class":451},"{})\n",[434,599,600],{"class":436,"line":513},[434,601,603],{"emptyLinePlaceholder":602},true,"\n",[434,605,606,608,610,612,614,616,618,620,622,624,626,628,630,632,634,636,638,640,642,644,646,648,650,652],{"class":436,"line":536},[434,607,441],{"class":440},[434,609,445],{"class":444},[434,611,448],{"class":440},[434,613,452],{"class":451},[434,615,456],{"class":455},[434,617,459],{"class":451},[434,619,462],{"class":440},[434,621,452],{"class":451},[434,623,467],{"class":455},[434,625,459],{"class":451},[434,627,473],{"class":472},[434,629,459],{"class":451},[434,631,479],{"class":478},[434,633,483],{"class":482},[434,635,452],{"class":451},[434,637,488],{"class":482},[434,639,491],{"class":451},[434,641,494],{"class":478},[434,643,497],{"class":472},[434,645,462],{"class":482},[434,647,452],{"class":451},[434,649,504],{"class":482},[434,651,507],{"class":451},[434,653,510],{"class":451},[434,655,656,660,662,664,667,669,672,676,680,684,687],{"class":436,"line":542},[434,657,659],{"class":658},"s7Bcg","    if",[434,661,494],{"class":440},[434,663,452],{"class":451},[434,665,666],{"class":440},"URL",[434,668,452],{"class":451},[434,670,671],{"class":440},"Path",[434,673,675],{"class":674},"sRBoR"," ==",[434,677,679],{"class":678},"sED5a"," \"",[434,681,683],{"class":682},"sVazx","\u002Ffirst",[434,685,686],{"class":678},"\"",[434,688,510],{"class":451},[434,690,692,695],{"class":436,"line":691},5,[434,693,694],{"class":674},"        \u003C-",[434,696,697],{"class":440},"releaseFirst\n",[434,699,701],{"class":436,"line":700},6,[434,702,703],{"class":451},"    }\n",[434,705,707,709,711,713,715,717,719,722],{"class":436,"line":706},7,[434,708,516],{"class":440},[434,710,452],{"class":451},[434,712,521],{"class":455},[434,714,459],{"class":451},[434,716,462],{"class":440},[434,718,452],{"class":451},[434,720,721],{"class":440},"StatusOK",[434,723,533],{"class":451},[434,725,727],{"class":436,"line":726},8,[434,728,539],{"class":451},[434,730,732,734,736,738,740,742,744,746],{"class":436,"line":731},9,[434,733,545],{"class":440},[434,735,452],{"class":451},[434,737,550],{"class":455},[434,739,459],{"class":451},[434,741,441],{"class":440},[434,743,452],{"class":451},[434,745,559],{"class":440},[434,747,533],{"class":451},[394,749,750,751,753,754,757,758,760],{},"Start checking ",[421,752,683],{}," and ",[421,755,756],{},"\u002Fsecond",", confirm the second handler is reached, then close ",[421,759,581],{},". The first request finishes last, but returned results must follow input indexes.",[394,762,763,764,767],{},"Use channels to observe events. Avoid ",[421,765,766],{},"time.Sleep"," as the primary ordering mechanism.",[389,769,771],{"id":770},"verify-the-worker-bound","Verify the worker bound",[425,773,775],{"className":427,"code":774,"language":429,"meta":430,"style":430},"var current atomic.Int64\nvar maximum atomic.Int64\n    release := make(chan struct{})\n\nhandler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n    active := current.Add(1)\n    defer current.Add(-1)\n\n    for {\n        seen := maximum.Load()\n        if active \u003C= seen || maximum.CompareAndSwap(seen, active) {\n            break\n        }\n    }\n\n    \u003C-release\n    w.WriteHeader(http.StatusNoContent)\n})\n",[421,776,777,793,806,823,827,870,892,912,916,923,941,979,985,991,996,1001,1010,1029],{"__ignoreMap":430},[434,778,779,782,785,788,790],{"class":436,"line":437},[434,780,781],{"class":472},"var",[434,783,784],{"class":440}," current",[434,786,787],{"class":482}," atomic",[434,789,452],{"class":451},[434,791,792],{"class":482},"Int64\n",[434,794,795,797,800,802,804],{"class":436,"line":513},[434,796,781],{"class":472},[434,798,799],{"class":440}," maximum",[434,801,787],{"class":482},[434,803,452],{"class":451},[434,805,792],{"class":482},[434,807,808,811,813,815,817,819,821],{"class":436,"line":536},[434,809,810],{"class":440},"    release",[434,812,445],{"class":444},[434,814,586],{"class":455},[434,816,459],{"class":451},[434,818,591],{"class":472},[434,820,594],{"class":472},[434,822,597],{"class":451},[434,824,825],{"class":436,"line":542},[434,826,603],{"emptyLinePlaceholder":602},[434,828,829,832,834,836,838,840,842,844,846,848,850,852,854,856,858,860,862,864,866,868],{"class":436,"line":691},[434,830,831],{"class":440},"handler",[434,833,445],{"class":444},[434,835,483],{"class":440},[434,837,452],{"class":451},[434,839,467],{"class":455},[434,841,459],{"class":451},[434,843,473],{"class":472},[434,845,459],{"class":451},[434,847,479],{"class":478},[434,849,483],{"class":482},[434,851,452],{"class":451},[434,853,488],{"class":482},[434,855,491],{"class":451},[434,857,494],{"class":478},[434,859,497],{"class":472},[434,861,462],{"class":482},[434,863,452],{"class":451},[434,865,504],{"class":482},[434,867,507],{"class":451},[434,869,510],{"class":451},[434,871,872,875,877,879,881,884,886,890],{"class":436,"line":700},[434,873,874],{"class":440},"    active",[434,876,445],{"class":444},[434,878,784],{"class":440},[434,880,452],{"class":451},[434,882,883],{"class":455},"Add",[434,885,459],{"class":451},[434,887,889],{"class":888},"sAJzr","1",[434,891,533],{"class":451},[434,893,894,897,899,901,903,905,908,910],{"class":436,"line":706},[434,895,896],{"class":658},"    defer",[434,898,784],{"class":440},[434,900,452],{"class":451},[434,902,883],{"class":455},[434,904,459],{"class":451},[434,906,907],{"class":472},"-",[434,909,889],{"class":888},[434,911,533],{"class":451},[434,913,914],{"class":436,"line":726},[434,915,603],{"emptyLinePlaceholder":602},[434,917,918,921],{"class":436,"line":731},[434,919,920],{"class":658},"    for",[434,922,510],{"class":451},[434,924,926,929,931,933,935,938],{"class":436,"line":925},10,[434,927,928],{"class":440},"        seen",[434,930,445],{"class":444},[434,932,799],{"class":440},[434,934,452],{"class":451},[434,936,937],{"class":455},"Load",[434,939,940],{"class":451},"()\n",[434,942,944,947,950,953,956,959,961,963,966,968,971,973,975,977],{"class":436,"line":943},11,[434,945,946],{"class":658},"        if",[434,948,949],{"class":440}," active",[434,951,952],{"class":674}," \u003C=",[434,954,955],{"class":440}," seen",[434,957,958],{"class":674}," ||",[434,960,799],{"class":440},[434,962,452],{"class":451},[434,964,965],{"class":455},"CompareAndSwap",[434,967,459],{"class":451},[434,969,970],{"class":440},"seen",[434,972,491],{"class":451},[434,974,949],{"class":440},[434,976,507],{"class":451},[434,978,510],{"class":451},[434,980,982],{"class":436,"line":981},12,[434,983,984],{"class":658},"            break\n",[434,986,988],{"class":436,"line":987},13,[434,989,990],{"class":451},"        }\n",[434,992,994],{"class":436,"line":993},14,[434,995,703],{"class":451},[434,997,999],{"class":436,"line":998},15,[434,1000,603],{"emptyLinePlaceholder":602},[434,1002,1004,1007],{"class":436,"line":1003},16,[434,1005,1006],{"class":674},"    \u003C-",[434,1008,1009],{"class":440},"release\n",[434,1011,1013,1015,1017,1019,1021,1023,1025,1027],{"class":436,"line":1012},17,[434,1014,516],{"class":440},[434,1016,452],{"class":451},[434,1018,521],{"class":455},[434,1020,459],{"class":451},[434,1022,462],{"class":440},[434,1024,452],{"class":451},[434,1026,530],{"class":440},[434,1028,533],{"class":451},[434,1030,1032],{"class":436,"line":1031},18,[434,1033,1034],{"class":451},"})\n",[394,1036,1037,1038,1041],{},"Start more jobs than workers. Wait until the expected number has entered, then assert ",[421,1039,1040],{},"maximum \u003C= workers"," and release the handlers. The full test needs a bounded timeout so a broken pipeline fails instead of hanging forever.",[389,1043,1045],{"id":1044},"test-request-timeout","Test request timeout",[425,1047,1049],{"className":427,"code":1048,"language":429,"meta":430,"style":430},"started := make(chan struct{})\nserver := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n    close(started)\n    \u003C-r.Context().Done()\n}))\nt.Cleanup(server.Close)\n",[421,1050,1051,1068,1118,1129,1149,1153],{"__ignoreMap":430},[434,1052,1053,1056,1058,1060,1062,1064,1066],{"class":436,"line":437},[434,1054,1055],{"class":440},"started",[434,1057,445],{"class":444},[434,1059,586],{"class":455},[434,1061,459],{"class":451},[434,1063,591],{"class":472},[434,1065,594],{"class":472},[434,1067,597],{"class":451},[434,1069,1070,1072,1074,1076,1078,1080,1082,1084,1086,1088,1090,1092,1094,1096,1098,1100,1102,1104,1106,1108,1110,1112,1114,1116],{"class":436,"line":513},[434,1071,441],{"class":440},[434,1073,445],{"class":444},[434,1075,448],{"class":440},[434,1077,452],{"class":451},[434,1079,456],{"class":455},[434,1081,459],{"class":451},[434,1083,462],{"class":440},[434,1085,452],{"class":451},[434,1087,467],{"class":455},[434,1089,459],{"class":451},[434,1091,473],{"class":472},[434,1093,459],{"class":451},[434,1095,479],{"class":478},[434,1097,483],{"class":482},[434,1099,452],{"class":451},[434,1101,488],{"class":482},[434,1103,491],{"class":451},[434,1105,494],{"class":478},[434,1107,497],{"class":472},[434,1109,462],{"class":482},[434,1111,452],{"class":451},[434,1113,504],{"class":482},[434,1115,507],{"class":451},[434,1117,510],{"class":451},[434,1119,1120,1123,1125,1127],{"class":436,"line":536},[434,1121,1122],{"class":455},"    close",[434,1124,459],{"class":451},[434,1126,1055],{"class":440},[434,1128,533],{"class":451},[434,1130,1131,1133,1136,1138,1141,1144,1147],{"class":436,"line":542},[434,1132,1006],{"class":674},[434,1134,1135],{"class":440},"r",[434,1137,452],{"class":451},[434,1139,1140],{"class":455},"Context",[434,1142,1143],{"class":451},"().",[434,1145,1146],{"class":455},"Done",[434,1148,940],{"class":451},[434,1150,1151],{"class":436,"line":691},[434,1152,539],{"class":451},[434,1154,1155,1157,1159,1161,1163,1165,1167,1169],{"class":436,"line":700},[434,1156,545],{"class":440},[434,1158,452],{"class":451},[434,1160,550],{"class":455},[434,1162,459],{"class":451},[434,1164,441],{"class":440},[434,1166,452],{"class":451},[434,1168,559],{"class":440},[434,1170,533],{"class":451},[394,1172,1173,1174,1176,1177,1180,1181,1184],{},"Run a check with a short timeout, wait for ",[421,1175,1055],{},", and assert the result error matches ",[421,1178,1179],{},"context.DeadlineExceeded"," through ",[421,1182,1183],{},"errors.Is"," where the wrapping chain supports it.",[394,1186,1187],{},"Avoid comparing complete network error strings; their formatting is not a stable contract.",[389,1189,1191],{"id":1190},"test-command-cancellation","Test command cancellation",[1193,1194,1195,1198,1201,1204,1210],"ol",{},[401,1196,1197],{},"Handler signals that a request began.",[401,1199,1200],{},"Test cancels the parent context.",[401,1202,1203],{},"Handler observes request-context cancellation.",[401,1205,1206,1209],{},[421,1207,1208],{},"CheckAll"," returns within a bounded test deadline.",[401,1211,1212],{},"Every worker completion signal is observed.",[394,1214,1215],{},"The test's outer deadline is a safety net, not the mechanism that creates the intended order.",[389,1217,1219],{"id":1218},"check-response-cleanup","Check response cleanup",[394,1221,1222,1223,1226,1227,1229],{},"A custom ",[421,1224,1225],{},"RoundTripper"," can return a response body whose ",[421,1228,559],{}," method records the call:",[425,1231,1233],{"className":427,"code":1232,"language":429,"meta":430,"style":430},"type recordingBody struct {\n    io.Reader\n    closed atomic.Bool\n}\n\nfunc (b *recordingBody) Close() error {\n    b.closed.Store(true)\n    return nil\n}\n",[421,1234,1235,1247,1257,1269,1274,1278,1308,1331,1340],{"__ignoreMap":430},[434,1236,1237,1240,1243,1245],{"class":436,"line":437},[434,1238,1239],{"class":472},"type",[434,1241,1242],{"class":482}," recordingBody",[434,1244,594],{"class":472},[434,1246,510],{"class":451},[434,1248,1249,1252,1254],{"class":436,"line":513},[434,1250,1251],{"class":482},"    io",[434,1253,452],{"class":451},[434,1255,1256],{"class":482},"Reader\n",[434,1258,1259,1262,1264,1266],{"class":436,"line":536},[434,1260,1261],{"class":440},"    closed",[434,1263,787],{"class":482},[434,1265,452],{"class":451},[434,1267,1268],{"class":482},"Bool\n",[434,1270,1271],{"class":436,"line":542},[434,1272,1273],{"class":451},"}\n",[434,1275,1276],{"class":436,"line":691},[434,1277,603],{"emptyLinePlaceholder":602},[434,1279,1280,1282,1285,1288,1291,1294,1296,1299,1302,1306],{"class":436,"line":700},[434,1281,473],{"class":472},[434,1283,1284],{"class":451}," (",[434,1286,1287],{"class":478},"b ",[434,1289,1290],{"class":472},"*",[434,1292,1293],{"class":482},"recordingBody",[434,1295,507],{"class":451},[434,1297,1298],{"class":455}," Close",[434,1300,1301],{"class":451},"()",[434,1303,1305],{"class":1304},"sF6sA"," error",[434,1307,510],{"class":451},[434,1309,1310,1313,1315,1318,1320,1323,1325,1329],{"class":436,"line":706},[434,1311,1312],{"class":440},"    b",[434,1314,452],{"class":451},[434,1316,1317],{"class":440},"closed",[434,1319,452],{"class":451},[434,1321,1322],{"class":455},"Store",[434,1324,459],{"class":451},[434,1326,1328],{"class":1327},"sqQ1y","true",[434,1330,533],{"class":451},[434,1332,1333,1336],{"class":436,"line":726},[434,1334,1335],{"class":658},"    return",[434,1337,1339],{"class":1338},"sp8Z5"," nil\n",[434,1341,1342],{"class":436,"line":731},[434,1343,1273],{"class":451},[394,1345,1346,1347,1350,1351,1354],{},"Inject an ",[421,1348,1349],{},"http.Client"," using the transport and assert the body is closed after ",[421,1352,1353],{},"check"," returns.",[389,1356,1358],{"id":1357},"race-and-leak-validation","Race and leak validation",[394,1360,1361],{},"When a Go environment is available:",[425,1363,1367],{"className":1364,"code":1365,"language":1366,"meta":430,"style":430},"language-bash shiki shiki-themes solarized-light material-theme one-dark-pro","go test -race -count=20 .\u002F...\n","bash",[421,1368,1369],{"__ignoreMap":430},[434,1370,1371,1374,1377,1381,1384],{"class":436,"line":437},[434,1372,429],{"class":1373},"sqRHY",[434,1375,1376],{"class":682}," test",[434,1378,1380],{"class":1379},"s2SA0"," -race",[434,1382,1383],{"class":1379}," -count=20",[434,1385,1386],{"class":682}," .\u002F...\n",[394,1388,1389],{},"Repeated tests increase the chance of exercising schedules but still do not prove correctness.",[394,1391,1392],{},"Goroutine-count assertions are noisy because the runtime and HTTP transport own goroutines. Prefer explicit worker completion channels or wait groups. A goroutine profile can help diagnose unexplained growth.",[389,1394,1396],{"id":1395},"final-completion-checklist","Final completion checklist",[398,1398,1399,1402,1405,1408,1411,1414,1417,1420,1423],{},[401,1400,1401],{},"malformed URLs fail before workers start;",[401,1403,1404],{},"worker count and queue size are bounded;",[401,1406,1407],{},"every successful response body closes;",[401,1409,1410],{},"request and parent cancellation propagate;",[401,1412,1413],{},"output order matches input order;",[401,1415,1416],{},"per-result failure policy is tested;",[401,1418,1419],{},"public internet is not used by tests;",[401,1421,1422],{},"race-enabled repeated tests complete cleanly in a supported environment;",[401,1424,1425],{},"command help documents security scope and limits.",[389,1427,1429],{"id":1428},"practice","Practice",[394,1431,1432],{},"Add optional first-error cancellation. Ensure the collector continues draining until workers exit so a worker never blocks sending the error that triggered cancellation.",[1434,1435,1436],"accordion",{},[1437,1438,1441,1456,1608],"accordion-item",{"icon":1439,"label":1440},"i-lucide-lightbulb","Show cancellation design",[394,1442,1443,1444,1447,1448,1451,1452,1455],{},"Create a child context for the operation. When the collector receives the first ",[421,1445,1446],{},"Result"," with an error, call ",[421,1449,1450],{},"cancel"," but continue ranging over ",[421,1453,1454],{},"resultChannel"," until it closes.",[425,1457,1459],{"className":427,"code":1458,"language":429,"meta":430,"style":430},"operationCtx, cancel := context.WithCancel(ctx)\ndefer cancel()\n\nvar firstError error\nfor result := range resultChannel {\n    results = append(results, result)\n    if result.Err != nil && firstError == nil {\n        firstError = result.Err\n        cancel()\n    }\n}\n",[421,1460,1461,1488,1497,1501,1511,1529,1551,1579,1593,1600,1604],{"__ignoreMap":430},[434,1462,1463,1466,1468,1471,1473,1476,1478,1481,1483,1486],{"class":436,"line":437},[434,1464,1465],{"class":440},"operationCtx",[434,1467,491],{"class":451},[434,1469,1470],{"class":440}," cancel",[434,1472,445],{"class":444},[434,1474,1475],{"class":440}," context",[434,1477,452],{"class":451},[434,1479,1480],{"class":455},"WithCancel",[434,1482,459],{"class":451},[434,1484,1485],{"class":440},"ctx",[434,1487,533],{"class":451},[434,1489,1490,1493,1495],{"class":436,"line":513},[434,1491,1492],{"class":658},"defer",[434,1494,1470],{"class":455},[434,1496,940],{"class":451},[434,1498,1499],{"class":436,"line":536},[434,1500,603],{"emptyLinePlaceholder":602},[434,1502,1503,1505,1508],{"class":436,"line":542},[434,1504,781],{"class":472},[434,1506,1507],{"class":440}," firstError",[434,1509,1510],{"class":1304}," error\n",[434,1512,1513,1516,1519,1521,1524,1527],{"class":436,"line":691},[434,1514,1515],{"class":658},"for",[434,1517,1518],{"class":440}," result",[434,1520,445],{"class":444},[434,1522,1523],{"class":658}," range",[434,1525,1526],{"class":440}," resultChannel",[434,1528,510],{"class":451},[434,1530,1531,1534,1537,1540,1542,1545,1547,1549],{"class":436,"line":700},[434,1532,1533],{"class":440},"    results",[434,1535,1536],{"class":444}," =",[434,1538,1539],{"class":455}," append",[434,1541,459],{"class":451},[434,1543,1544],{"class":440},"results",[434,1546,491],{"class":451},[434,1548,1518],{"class":440},[434,1550,533],{"class":451},[434,1552,1553,1555,1557,1559,1562,1565,1568,1571,1573,1575,1577],{"class":436,"line":706},[434,1554,659],{"class":658},[434,1556,1518],{"class":440},[434,1558,452],{"class":451},[434,1560,1561],{"class":440},"Err",[434,1563,1564],{"class":674}," !=",[434,1566,1567],{"class":1338}," nil",[434,1569,1570],{"class":674}," &&",[434,1572,1507],{"class":440},[434,1574,675],{"class":674},[434,1576,1567],{"class":1338},[434,1578,510],{"class":451},[434,1580,1581,1584,1586,1588,1590],{"class":436,"line":726},[434,1582,1583],{"class":440},"        firstError",[434,1585,1536],{"class":444},[434,1587,1518],{"class":440},[434,1589,452],{"class":451},[434,1591,1592],{"class":440},"Err\n",[434,1594,1595,1598],{"class":436,"line":731},[434,1596,1597],{"class":455},"        cancel",[434,1599,940],{"class":451},[434,1601,1602],{"class":436,"line":925},[434,1603,703],{"class":451},[434,1605,1606],{"class":436,"line":943},[434,1607,1273],{"class":451},[394,1609,1610,1611,1613],{},"Workers use ",[421,1612,1465],{}," around job receive, HTTP request, and result send. Define whether results produced before cancellation are returned with the error. Test the contract explicitly.",[389,1615,1617],{"id":1616},"summary","Summary",[398,1619,1620,1623,1626,1629,1632],{},[401,1621,1622],{},"Local test servers make network behaviour controllable and repeatable.",[401,1624,1625],{},"Channels create deterministic test ordering without arbitrary sleeps.",[401,1627,1628],{},"Atomic counters can verify actual maximum concurrency.",[401,1630,1631],{},"Assert error identity or classification instead of unstable text.",[401,1633,1634],{},"Confirm owned goroutines finish; raw runtime goroutine counts are only diagnostic clues.",[1636,1637],"learning-lesson-complete",{},[1639,1640],"learning-lesson-navigation",{"next":334,"next-label":1641,"previous":326,"previous-label":1642},"Project: File-Backed API","URL Checker: Worker Pipeline",[1644,1645,1646],"style",{},"html pre.shiki code .s45-6, html code.shiki .s45-6{--shiki-light:#268BD2;--shiki-default:#EEFFFF;--shiki-dark:#E06C75}html pre.shiki code .su2KV, html code.shiki .su2KV{--shiki-light:#859900;--shiki-default:#89DDFF;--shiki-dark:#E5C07B}html pre.shiki code .shFME, html code.shiki .shFME{--shiki-light:#657B83;--shiki-default:#89DDFF;--shiki-dark:#ABB2BF}html pre.shiki code .sisdC, html code.shiki .sisdC{--shiki-light:#268BD2;--shiki-default:#82AAFF;--shiki-dark:#61AFEF}html pre.shiki code .sEOdo, html code.shiki .sEOdo{--shiki-light:#859900;--shiki-default:#89DDFF;--shiki-dark:#C678DD}html pre.shiki code .syre3, html code.shiki .syre3{--shiki-light:#657B83;--shiki-light-font-style:inherit;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#E06C75;--shiki-dark-font-style:italic}html pre.shiki code .snwKR, html code.shiki .snwKR{--shiki-light:#CB4B16;--shiki-default:#FFCB6B;--shiki-dark:#E5C07B}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 .s7Bcg, html code.shiki .s7Bcg{--shiki-light:#859900;--shiki-light-font-style:inherit;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#C678DD;--shiki-dark-font-style:inherit}html pre.shiki code .sRBoR, html code.shiki .sRBoR{--shiki-light:#859900;--shiki-default:#89DDFF;--shiki-dark:#56B6C2}html pre.shiki code .sED5a, html code.shiki .sED5a{--shiki-light:#2AA198;--shiki-default:#89DDFF;--shiki-dark:#98C379}html pre.shiki code .sVazx, html code.shiki .sVazx{--shiki-light:#2AA198;--shiki-default:#C3E88D;--shiki-dark:#98C379}html pre.shiki code .sAJzr, html code.shiki .sAJzr{--shiki-light:#D33682;--shiki-default:#F78C6C;--shiki-dark:#D19A66}html pre.shiki code .sF6sA, html code.shiki .sF6sA{--shiki-light:#586E75;--shiki-light-font-weight:bold;--shiki-default:#C792EA;--shiki-default-font-weight:inherit;--shiki-dark:#C678DD;--shiki-dark-font-weight:inherit}html pre.shiki code .sqQ1y, html code.shiki .sqQ1y{--shiki-light:#B58900;--shiki-default:#FF9CAC;--shiki-dark:#D19A66}html pre.shiki code .sp8Z5, html code.shiki .sp8Z5{--shiki-light:#B58900;--shiki-default:#89DDFF;--shiki-dark:#D19A66}html pre.shiki code .sqRHY, html code.shiki .sqRHY{--shiki-light:#268BD2;--shiki-default:#FFCB6B;--shiki-dark:#61AFEF}html pre.shiki code .s2SA0, html code.shiki .s2SA0{--shiki-light:#CB4B16;--shiki-default:#C3E88D;--shiki-dark:#D19A66}",{"title":430,"searchDepth":513,"depth":513,"links":1648},[1649,1650,1652,1653,1654,1655,1656,1657,1658,1659,1660],{"id":391,"depth":513,"text":392},{"id":418,"depth":513,"text":1651},"Use httptest.Server",{"id":567,"depth":513,"text":568},{"id":770,"depth":513,"text":771},{"id":1044,"depth":513,"text":1045},{"id":1190,"depth":513,"text":1191},{"id":1218,"depth":513,"text":1219},{"id":1357,"depth":513,"text":1358},{"id":1395,"depth":513,"text":1396},{"id":1428,"depth":513,"text":1429},{"id":1616,"depth":513,"text":1617},"Prove worker limits, timeout behaviour, ordering, cleanup, and race-free execution with controlled servers.","md",null,{},{"icon":173},{"description":1667,"title":329},"Test a concurrent Go URL checker with httptest servers, deterministic cancellation, concurrency counters, race detection, and leak checks.","etrgcrHMb6HkqDn_oXEcXrTjQ2LNS7h87z7vro5huSQ",[1670,1672],{"title":325,"path":326,"stem":327,"description":1671,"icon":128,"children":-1},"Implement bounded workers, request lifetimes, result ownership, and ordered collection.",{"title":338,"path":334,"stem":335,"description":1673,"children":-1},"Design an intermediate HTTP API with clear layers, durable JSON storage, and predictable errors.",1794118105493]