[{"data":1,"prerenderedAt":2022},["ShallowReactive",2],{"blog-post-\u002Fko\u002Fnuxt-usefetch-await-blocks-navigation":3,"blog-related-source":1626},{"id":4,"title":5,"body":6,"description":1613,"extension":1614,"meta":1615,"navigation":826,"path":1621,"seo":1622,"sitemap":1623,"stem":1624,"__hash__":1625},"ko\u002Fko\u002Fnuxt-usefetch-await-blocks-navigation.md","Nuxt useFetch를 await하면 페이지 전환이 멈추는 이유: useLazyFetch로 2.4초 대기 없애기",{"type":7,"value":8,"toc":1598},"minimark",[9,14,23,26,105,112,115,157,160,164,181,184,275,321,335,340,398,411,436,438,442,451,492,690,697,702,704,708,920,962,974,984,986,990,1002,1226,1233,1237,1244,1330,1334,1365,1424,1426,1428,1477,1480,1534,1546,1564,1568,1594],[10,11,13],"h2",{"id":12},"눌렀는데-24초-동안-아무-일도-안-일어난다","눌렀는데 2.4초 동안 아무 일도 안 일어난다",[15,16,17,18,22],"p",{},"관광 정보 서비스를 Nuxt로 만들던 중이었다. 목록에서 관광지 하나를 누르면 상세 페이지로 가는데, ",[19,20,21],"strong",{},"누른 뒤 2.4초 동안 화면이 그대로","였다. 로딩 표시도 없이 목록이 계속 보이니, 사용자 입장에서는 클릭이 안 된 것처럼 느껴진다.",[15,24,25],{},"상세 페이지 코드는 이랬다.",[27,28,33],"pre",{"className":29,"code":30,"language":31,"meta":32,"style":32},"language-js shiki shiki-themes github-light github-dark","\u002F\u002F pages\u002Fspots\u002F[id].vue\nconst { data: spot } = await useFetch(() => `\u002Fapi\u002Fspots\u002F${id.value}`)\n","js","",[34,35,36,45],"code",{"__ignoreMap":32},[37,38,41],"span",{"class":39,"line":40},"line",1,[37,42,44],{"class":43},"sJ8bj","\u002F\u002F pages\u002Fspots\u002F[id].vue\n",[37,46,48,52,56,60,63,67,70,73,76,80,83,86,90,93,96,99,102],{"class":39,"line":47},2,[37,49,51],{"class":50},"szBVR","const",[37,53,55],{"class":54},"sVt8B"," { ",[37,57,59],{"class":58},"s4XuR","data",[37,61,62],{"class":54},": ",[37,64,66],{"class":65},"sj4cs","spot",[37,68,69],{"class":54}," } ",[37,71,72],{"class":50},"=",[37,74,75],{"class":50}," await",[37,77,79],{"class":78},"sScJk"," useFetch",[37,81,82],{"class":54},"(() ",[37,84,85],{"class":50},"=>",[37,87,89],{"class":88},"sZZnC"," `\u002Fapi\u002Fspots\u002F${",[37,91,92],{"class":54},"id",[37,94,95],{"class":88},".",[37,97,98],{"class":54},"value",[37,100,101],{"class":88},"}`",[37,103,104],{"class":54},")\n",[15,106,107,108,111],{},"그리고 상세 API는 관광공사 API에서 정보를 가져온 뒤, ",[19,109,110],{},"Claude API로 소개글 요약까지 만들어서"," 한 번에 돌려주고 있었다. 이 요약 호출이 1~2초 걸렸다.",[15,113,114],{},"원인은 두 가지가 겹친 것이었다.",[116,117,118,131],"table",{},[119,120,121],"thead",{},[122,123,124,128],"tr",{},[125,126,127],"th",{},"원인",[125,129,130],{},"결과",[132,133,134,143],"tbody",{},[122,135,136,140],{},[137,138,139],"td",{},"상세 API가 느린 AI 요약까지 끝내고 응답",[137,141,142],{},"상세 응답 자체가 1~2초 늦어짐",[122,144,145,151],{},[137,146,147,148],{},"페이지에서 ",[34,149,150],{},"await useFetch",[137,152,153,154],{},"그 응답이 올 때까지 ",[19,155,156],{},"페이지 이동이 멈춤",[158,159],"hr",{},[10,161,163],{"id":162},"await-usefetch는-페이지-이동을-막는다","await useFetch는 페이지 이동을 막는다",[165,166,167],"blockquote",{},[15,168,169,172,173,176,177,180],{},[34,170,171],{},"useFetch","를 ",[34,174,175],{},"await","하면, Nuxt는 ",[19,178,179],{},"데이터가 올 때까지 다음 페이지로 넘어가지 않는다."," 그동안 사용자는 이전 페이지를 계속 보고 있다.",[15,182,183],{},"말로만 들으면 와닿지 않아서, 2초 걸리는 API를 만들어 직접 재 봤다. 목록 페이지에서 링크를 누르고, 다음 페이지 제목이 보일 때까지의 시간이다.",[27,185,187],{"className":29,"code":186,"language":31,"meta":32,"style":32},"\u002F\u002F 2초 뒤에 응답하는 테스트 API\nexport default defineEventHandler(async () => {\n  await new Promise((r) => setTimeout(r, 2000))\n  return { ok: true }\n})\n",[34,188,189,194,219,254,269],{"__ignoreMap":32},[37,190,191],{"class":39,"line":40},[37,192,193],{"class":43},"\u002F\u002F 2초 뒤에 응답하는 테스트 API\n",[37,195,196,199,202,205,208,211,214,216],{"class":39,"line":47},[37,197,198],{"class":50},"export",[37,200,201],{"class":50}," default",[37,203,204],{"class":78}," defineEventHandler",[37,206,207],{"class":54},"(",[37,209,210],{"class":50},"async",[37,212,213],{"class":54}," () ",[37,215,85],{"class":50},[37,217,218],{"class":54}," {\n",[37,220,222,225,228,231,234,237,240,242,245,248,251],{"class":39,"line":221},3,[37,223,224],{"class":50},"  await",[37,226,227],{"class":50}," new",[37,229,230],{"class":65}," Promise",[37,232,233],{"class":54},"((",[37,235,236],{"class":58},"r",[37,238,239],{"class":54},") ",[37,241,85],{"class":50},[37,243,244],{"class":78}," setTimeout",[37,246,247],{"class":54},"(r, ",[37,249,250],{"class":65},"2000",[37,252,253],{"class":54},"))\n",[37,255,257,260,263,266],{"class":39,"line":256},4,[37,258,259],{"class":50},"  return",[37,261,262],{"class":54}," { ok: ",[37,264,265],{"class":65},"true",[37,267,268],{"class":54}," }\n",[37,270,272],{"class":39,"line":271},5,[37,273,274],{"class":54},"})\n",[116,276,277,290],{},[119,278,279],{},[122,280,281,284,287],{},[125,282,283],{},"페이지 코드",[125,285,286],{},"다음 페이지가 보이기까지",[125,288,289],{},"데이터가 오기까지",[132,291,292,306],{},[122,293,294,299,304],{},[137,295,296],{},[34,297,298],{},"await useFetch(...)",[137,300,301],{},[19,302,303],{},"약 2,400ms",[137,305,303],{},[122,307,308,313,318],{},[137,309,310],{},[34,311,312],{},"useLazyFetch(...)",[137,314,315],{},[19,316,317],{},"약 100ms",[137,319,320],{},"약 2,100ms",[15,322,323,324,327,328,330,331,334],{},"데이터가 오는 시간은 둘 다 2초 남짓으로 비슷하다. 다른 건 ",[19,325,326],{},"화면이 바뀌는 시점","이다. ",[34,329,150],{},"는 데이터가 올 때까지 이전 페이지에 머물고, ",[34,332,333],{},"useLazyFetch","는 바로 다음 페이지로 넘어간 뒤 데이터를 기다린다. (Nuxt 3.21 개발 서버, Chromium에서 각각 두 번씩 잰 값이다.)",[336,337,339],"h3",{"id":338},"uselazyfetch는-usefetch에-lazy를-켠-것","useLazyFetch는 useFetch에 lazy를 켠 것",[27,341,343],{"className":29,"code":342,"language":31,"meta":32,"style":32},"\u002F\u002F 둘은 같다\nconst { data } = useLazyFetch('\u002Fapi\u002Fspots\u002F1')\nconst { data } = useFetch('\u002Fapi\u002Fspots\u002F1', { lazy: true })\n",[34,344,345,350,372],{"__ignoreMap":32},[37,346,347],{"class":39,"line":40},[37,348,349],{"class":43},"\u002F\u002F 둘은 같다\n",[37,351,352,354,356,358,360,362,365,367,370],{"class":39,"line":47},[37,353,51],{"class":50},[37,355,55],{"class":54},[37,357,59],{"class":65},[37,359,69],{"class":54},[37,361,72],{"class":50},[37,363,364],{"class":78}," useLazyFetch",[37,366,207],{"class":54},[37,368,369],{"class":88},"'\u002Fapi\u002Fspots\u002F1'",[37,371,104],{"class":54},[37,373,374,376,378,380,382,384,386,388,390,393,395],{"class":39,"line":221},[37,375,51],{"class":50},[37,377,55],{"class":54},[37,379,59],{"class":65},[37,381,69],{"class":54},[37,383,72],{"class":50},[37,385,79],{"class":78},[37,387,207],{"class":54},[37,389,369],{"class":88},[37,391,392],{"class":54},", { lazy: ",[37,394,265],{"class":65},[37,396,397],{"class":54}," })\n",[15,399,400,403,404,410],{},[34,401,402],{},"lazy","를 켜면 Nuxt가 데이터를 기다리지 않고 페이지부터 보여준다. 대신 ",[19,405,406,407,409],{},"처음에는 ",[34,408,59],{},"가 비어 있다","는 걸 화면에서 처리해야 한다.",[412,413,414],"warning",{},[165,415,416],{},[15,417,418,421,422,424,425,428,429,431,432,435],{},[19,419,420],{},"첫 접속에서는 둘 다 기다린다."," 주소를 직접 입력하거나 새로고침해서 들어오면, 서버가 HTML을 만들 때 데이터를 가져온다(서버 렌더링). 이때는 ",[34,423,333],{},"도 데이터를 기다린 뒤 HTML을 보낸다. 같은 테스트 페이지를 ",[34,426,427],{},"curl","로 요청해 보니 둘 다 약 2초가 걸렸고, HTML에는 데이터가 채워져 있었다. ",[34,430,402],{},"가 줄여 주는 건 ",[19,433,434],{},"앱 안에서 페이지를 이동할 때","의 대기다.",[158,437],{},[10,439,441],{"id":440},"고친-방법-1-느린-ai-요약을-별도-api로-분리","고친 방법 1: 느린 AI 요약을 별도 API로 분리",[15,443,444,446,447,450],{},[34,445,333],{},"로 바꾸기 전에 먼저 할 일이 있었다. ",[19,448,449],{},"응답 자체를 빠르게"," 만드는 것이다. 상세 API에서 AI 요약 호출을 빼고, 요약만 따로 돌려주는 API를 만들었다. (아래 코드는 설명에 필요한 부분만 남기고 줄였다.)",[27,452,456],{"className":453,"code":454,"language":455,"meta":32,"style":32},"language-ts shiki shiki-themes github-light github-dark","\u002F\u002F server\u002Fapi\u002Fspots\u002F[id].get.ts — 상세: AI 요약 호출을 뺐다\nconst detail = toSpotDetail(item, intro, images)\n\u002F\u002F AI 요약은 여기서 부르지 않는다. Claude 호출이 1~2초라 상세 전체가 그만큼 늦어진다.\nreturn detail\n","ts",[34,457,458,463,479,484],{"__ignoreMap":32},[37,459,460],{"class":39,"line":40},[37,461,462],{"class":43},"\u002F\u002F server\u002Fapi\u002Fspots\u002F[id].get.ts — 상세: AI 요약 호출을 뺐다\n",[37,464,465,467,470,473,476],{"class":39,"line":47},[37,466,51],{"class":50},[37,468,469],{"class":65}," detail",[37,471,472],{"class":50}," =",[37,474,475],{"class":78}," toSpotDetail",[37,477,478],{"class":54},"(item, intro, images)\n",[37,480,481],{"class":39,"line":221},[37,482,483],{"class":43},"\u002F\u002F AI 요약은 여기서 부르지 않는다. Claude 호출이 1~2초라 상세 전체가 그만큼 늦어진다.\n",[37,485,486,489],{"class":39,"line":256},[37,487,488],{"class":50},"return",[37,490,491],{"class":54}," detail\n",[27,493,495],{"className":453,"code":494,"language":455,"meta":32,"style":32},"\u002F\u002F server\u002Fapi\u002Fspots\u002F[id]\u002Fsummary.get.ts — 요약 전용\nexport default defineEventHandler(async (event) => {\n  const contentId = getRouterParam(event, 'id')\n  try {\n    const { name, overview, summary } = await getSpot(contentId) \u002F\u002F 상세와 같은 캐시를 쓴다\n    if (!overview) return { summary: null }\n    const aiSummary = await summarizeWithAI(contentId, name, overview)\n    return { summary: aiSummary ?? summary ?? null }\n  } catch {\n    return { summary: null } \u002F\u002F 요약은 없어도 페이지는 성립하므로 에러를 올리지 않는다\n  }\n})\n",[34,496,497,502,526,547,554,590,614,632,654,665,679,685],{"__ignoreMap":32},[37,498,499],{"class":39,"line":40},[37,500,501],{"class":43},"\u002F\u002F server\u002Fapi\u002Fspots\u002F[id]\u002Fsummary.get.ts — 요약 전용\n",[37,503,504,506,508,510,512,514,517,520,522,524],{"class":39,"line":47},[37,505,198],{"class":50},[37,507,201],{"class":50},[37,509,204],{"class":78},[37,511,207],{"class":54},[37,513,210],{"class":50},[37,515,516],{"class":54}," (",[37,518,519],{"class":58},"event",[37,521,239],{"class":54},[37,523,85],{"class":50},[37,525,218],{"class":54},[37,527,528,531,534,536,539,542,545],{"class":39,"line":221},[37,529,530],{"class":50},"  const",[37,532,533],{"class":65}," contentId",[37,535,472],{"class":50},[37,537,538],{"class":78}," getRouterParam",[37,540,541],{"class":54},"(event, ",[37,543,544],{"class":88},"'id'",[37,546,104],{"class":54},[37,548,549,552],{"class":39,"line":256},[37,550,551],{"class":50},"  try",[37,553,218],{"class":54},[37,555,556,559,561,564,567,570,572,575,577,579,581,584,587],{"class":39,"line":271},[37,557,558],{"class":50},"    const",[37,560,55],{"class":54},[37,562,563],{"class":65},"name",[37,565,566],{"class":54},", ",[37,568,569],{"class":65},"overview",[37,571,566],{"class":54},[37,573,574],{"class":65},"summary",[37,576,69],{"class":54},[37,578,72],{"class":50},[37,580,75],{"class":50},[37,582,583],{"class":78}," getSpot",[37,585,586],{"class":54},"(contentId) ",[37,588,589],{"class":43},"\u002F\u002F 상세와 같은 캐시를 쓴다\n",[37,591,593,596,598,601,604,606,609,612],{"class":39,"line":592},6,[37,594,595],{"class":50},"    if",[37,597,516],{"class":54},[37,599,600],{"class":50},"!",[37,602,603],{"class":54},"overview) ",[37,605,488],{"class":50},[37,607,608],{"class":54}," { summary: ",[37,610,611],{"class":65},"null",[37,613,268],{"class":54},[37,615,617,619,622,624,626,629],{"class":39,"line":616},7,[37,618,558],{"class":50},[37,620,621],{"class":65}," aiSummary",[37,623,472],{"class":50},[37,625,75],{"class":50},[37,627,628],{"class":78}," summarizeWithAI",[37,630,631],{"class":54},"(contentId, name, overview)\n",[37,633,635,638,641,644,647,649,652],{"class":39,"line":634},8,[37,636,637],{"class":50},"    return",[37,639,640],{"class":54}," { summary: aiSummary ",[37,642,643],{"class":50},"??",[37,645,646],{"class":54}," summary ",[37,648,643],{"class":50},[37,650,651],{"class":65}," null",[37,653,268],{"class":54},[37,655,657,660,663],{"class":39,"line":656},9,[37,658,659],{"class":54},"  } ",[37,661,662],{"class":50},"catch",[37,664,218],{"class":54},[37,666,668,670,672,674,676],{"class":39,"line":667},10,[37,669,637],{"class":50},[37,671,608],{"class":54},[37,673,611],{"class":65},[37,675,69],{"class":54},[37,677,678],{"class":43},"\u002F\u002F 요약은 없어도 페이지는 성립하므로 에러를 올리지 않는다\n",[37,680,682],{"class":39,"line":681},11,[37,683,684],{"class":54},"  }\n",[37,686,688],{"class":39,"line":687},12,[37,689,274],{"class":54},[15,691,692,693,696],{},"이것만으로 상세 API 응답이 ",[19,694,695],{},"0.1~0.4초","로 줄었다. 요약 API는 상세 API와 같은 캐시 키로 원본 데이터를 읽어서, 관광공사 API를 다시 부르지 않는다.",[165,698,699],{},[15,700,701],{},"느린 작업이 \"없어도 페이지가 성립하는 부가 정보\"라면, 메인 응답에 묶지 말고 따로 가져오게 한다.",[158,703],{},[10,705,707],{"id":706},"고친-방법-2-페이지는-uselazyfetch-요약은-server-false","고친 방법 2: 페이지는 useLazyFetch, 요약은 server: false",[27,709,711],{"className":29,"code":710,"language":31,"meta":32,"style":32},"\u002F\u002F pages\u002Fspots\u002F[id].vue\n\u002F\u002F 상세: 기다리지 않고 페이지부터 보여준다\nconst { data: spot, error, status } = useLazyFetch(() => `\u002Fapi\u002Fspots\u002F${id.value}`, {\n  key: () => `spot-${id.value}`,\n})\nconst pending = computed(() => status.value === 'pending')\n\n\u002F\u002F 요약: 브라우저에서만 가져온다\nconst { data: aiSummary, status: summaryStatus } = useLazyFetch(\n  () => `\u002Fapi\u002Fspots\u002F${id.value}\u002Fsummary`,\n  { key: () => `spot-summary-${id.value}`, server: false },\n)\n",[34,712,713,717,722,767,791,795,822,828,833,864,884,916],{"__ignoreMap":32},[37,714,715],{"class":39,"line":40},[37,716,44],{"class":43},[37,718,719],{"class":39,"line":47},[37,720,721],{"class":43},"\u002F\u002F 상세: 기다리지 않고 페이지부터 보여준다\n",[37,723,724,726,728,730,732,734,736,739,741,744,746,748,750,752,754,756,758,760,762,764],{"class":39,"line":221},[37,725,51],{"class":50},[37,727,55],{"class":54},[37,729,59],{"class":58},[37,731,62],{"class":54},[37,733,66],{"class":65},[37,735,566],{"class":54},[37,737,738],{"class":65},"error",[37,740,566],{"class":54},[37,742,743],{"class":65},"status",[37,745,69],{"class":54},[37,747,72],{"class":50},[37,749,364],{"class":78},[37,751,82],{"class":54},[37,753,85],{"class":50},[37,755,89],{"class":88},[37,757,92],{"class":54},[37,759,95],{"class":88},[37,761,98],{"class":54},[37,763,101],{"class":88},[37,765,766],{"class":54},", {\n",[37,768,769,772,775,777,780,782,784,786,788],{"class":39,"line":256},[37,770,771],{"class":78},"  key",[37,773,774],{"class":54},": () ",[37,776,85],{"class":50},[37,778,779],{"class":88}," `spot-${",[37,781,92],{"class":54},[37,783,95],{"class":88},[37,785,98],{"class":54},[37,787,101],{"class":88},[37,789,790],{"class":54},",\n",[37,792,793],{"class":39,"line":271},[37,794,274],{"class":54},[37,796,797,799,802,804,807,809,811,814,817,820],{"class":39,"line":592},[37,798,51],{"class":50},[37,800,801],{"class":65}," pending",[37,803,472],{"class":50},[37,805,806],{"class":78}," computed",[37,808,82],{"class":54},[37,810,85],{"class":50},[37,812,813],{"class":54}," status.value ",[37,815,816],{"class":50},"===",[37,818,819],{"class":88}," 'pending'",[37,821,104],{"class":54},[37,823,824],{"class":39,"line":616},[37,825,827],{"emptyLinePlaceholder":826},true,"\n",[37,829,830],{"class":39,"line":634},[37,831,832],{"class":43},"\u002F\u002F 요약: 브라우저에서만 가져온다\n",[37,834,835,837,839,841,843,846,848,850,852,855,857,859,861],{"class":39,"line":656},[37,836,51],{"class":50},[37,838,55],{"class":54},[37,840,59],{"class":58},[37,842,62],{"class":54},[37,844,845],{"class":65},"aiSummary",[37,847,566],{"class":54},[37,849,743],{"class":58},[37,851,62],{"class":54},[37,853,854],{"class":65},"summaryStatus",[37,856,69],{"class":54},[37,858,72],{"class":50},[37,860,364],{"class":78},[37,862,863],{"class":54},"(\n",[37,865,866,869,871,873,875,877,879,882],{"class":39,"line":667},[37,867,868],{"class":54},"  () ",[37,870,85],{"class":50},[37,872,89],{"class":88},[37,874,92],{"class":54},[37,876,95],{"class":88},[37,878,98],{"class":54},[37,880,881],{"class":88},"}\u002Fsummary`",[37,883,790],{"class":54},[37,885,886,889,892,894,896,899,901,903,905,907,910,913],{"class":39,"line":681},[37,887,888],{"class":54},"  { ",[37,890,891],{"class":78},"key",[37,893,774],{"class":54},[37,895,85],{"class":50},[37,897,898],{"class":88}," `spot-summary-${",[37,900,92],{"class":54},[37,902,95],{"class":88},[37,904,98],{"class":54},[37,906,101],{"class":88},[37,908,909],{"class":54},", server: ",[37,911,912],{"class":65},"false",[37,914,915],{"class":54}," },\n",[37,917,918],{"class":39,"line":687},[37,919,104],{"class":54},[116,921,922,932],{},[119,923,924],{},[122,925,926,929],{},[125,927,928],{},"옵션",[125,930,931],{},"효과",[132,933,934,948],{},[122,935,936,945],{},[137,937,938,940,941,944],{},[34,939,333],{}," (= ",[34,942,943],{},"lazy: true",")",[137,946,947],{},"앱 안에서 이동할 때 데이터를 기다리지 않는다",[122,949,950,955],{},[137,951,952],{},[34,953,954],{},"server: false",[137,956,957,958,961],{},"서버 렌더링 때는 아예 부르지 않고 ",[19,959,960],{},"브라우저에서만"," 가져온다",[15,963,964,965,967,968,970,971,973],{},"요약에 ",[34,966,954],{},"를 준 이유는 위의 경고 때문이다. ",[34,969,402],{},"만 주면 첫 접속에서는 서버가 요약까지 기다린다. 요약은 1~2초 걸리니, 첫 접속 HTML이 그만큼 늦어진다. ",[34,972,954],{},"면 서버는 요약 없이 HTML을 바로 보내고, 요약은 브라우저가 나중에 채운다.",[15,975,976,977,979,980,983],{},"다만 ",[34,978,954],{},"로 가져온 내용은 ",[19,981,982],{},"서버 HTML에 없다."," 검색엔진이 꼭 읽어야 하는 본문에는 쓰면 안 되고, 이번 AI 요약처럼 부가 정보에만 쓰는 게 맞다.",[158,985],{},[10,987,989],{"id":988},"고친-방법-3-기다리는-동안-보여줄-화면","고친 방법 3: 기다리는 동안 보여줄 화면",[15,991,992,994,995,997,998,1001],{},[34,993,333],{},"로 바꾸면 페이지가 먼저 뜨고 ",[34,996,66],{},"은 잠시 비어 있다. 그동안 빈 화면이 보이면 안 되니, ",[19,999,1000],{},"실제 레이아웃과 같은 크기의 스켈레톤","을 그렸다.",[27,1003,1007],{"className":1004,"code":1005,"language":1006,"meta":32,"style":32},"language-vue shiki shiki-themes github-light github-dark","\u003Ctemplate>\n  \u003Cdiv v-if=\"error\">관광지 정보를 불러오지 못했어요.\u003C\u002Fdiv>\n\n  \u003C!-- 실제 화면과 같은 골격. 데이터가 와도 레이아웃이 밀리지 않는다 -->\n  \u003Cdiv v-else-if=\"pending\" class=\"skeleton\" aria-hidden=\"true\">\n    \u003Cdiv class=\"skeleton__title\" \u002F>\n    \u003Cdiv class=\"skeleton__media\" \u002F>\n    \u003Cdiv v-for=\"n in 5\" :key=\"n\" class=\"skeleton__row\" \u002F>\n  \u003C\u002Fdiv>\n\n  \u003Ctemplate v-else-if=\"spot\">\n    \u003Ch1>{{ spot.name }}\u003C\u002Fh1>\n    ...\n  \u003C\u002Ftemplate>\n\u003C\u002Ftemplate>\n","vue",[34,1008,1009,1021,1044,1048,1053,1085,1105,1122,1155,1164,1168,1187,1201,1207,1216],{"__ignoreMap":32},[37,1010,1011,1014,1018],{"class":39,"line":40},[37,1012,1013],{"class":54},"\u003C",[37,1015,1017],{"class":1016},"s9eBZ","template",[37,1019,1020],{"class":54},">\n",[37,1022,1023,1026,1029,1032,1034,1037,1040,1042],{"class":39,"line":47},[37,1024,1025],{"class":54},"  \u003C",[37,1027,1028],{"class":1016},"div",[37,1030,1031],{"class":78}," v-if",[37,1033,72],{"class":54},[37,1035,1036],{"class":88},"\"error\"",[37,1038,1039],{"class":54},">관광지 정보를 불러오지 못했어요.\u003C\u002F",[37,1041,1028],{"class":1016},[37,1043,1020],{"class":54},[37,1045,1046],{"class":39,"line":221},[37,1047,827],{"emptyLinePlaceholder":826},[37,1049,1050],{"class":39,"line":256},[37,1051,1052],{"class":43},"  \u003C!-- 실제 화면과 같은 골격. 데이터가 와도 레이아웃이 밀리지 않는다 -->\n",[37,1054,1055,1057,1059,1062,1064,1067,1070,1072,1075,1078,1080,1083],{"class":39,"line":271},[37,1056,1025],{"class":54},[37,1058,1028],{"class":1016},[37,1060,1061],{"class":78}," v-else-if",[37,1063,72],{"class":54},[37,1065,1066],{"class":88},"\"pending\"",[37,1068,1069],{"class":78}," class",[37,1071,72],{"class":54},[37,1073,1074],{"class":88},"\"skeleton\"",[37,1076,1077],{"class":78}," aria-hidden",[37,1079,72],{"class":54},[37,1081,1082],{"class":88},"\"true\"",[37,1084,1020],{"class":54},[37,1086,1087,1090,1092,1094,1096,1099,1103],{"class":39,"line":592},[37,1088,1089],{"class":54},"    \u003C",[37,1091,1028],{"class":1016},[37,1093,1069],{"class":78},[37,1095,72],{"class":54},[37,1097,1098],{"class":88},"\"skeleton__title\"",[37,1100,1102],{"class":1101},"s7hpK"," \u002F",[37,1104,1020],{"class":54},[37,1106,1107,1109,1111,1113,1115,1118,1120],{"class":39,"line":616},[37,1108,1089],{"class":54},[37,1110,1028],{"class":1016},[37,1112,1069],{"class":78},[37,1114,72],{"class":54},[37,1116,1117],{"class":88},"\"skeleton__media\"",[37,1119,1102],{"class":1101},[37,1121,1020],{"class":54},[37,1123,1124,1126,1128,1131,1133,1136,1139,1141,1144,1146,1148,1151,1153],{"class":39,"line":634},[37,1125,1089],{"class":54},[37,1127,1028],{"class":1016},[37,1129,1130],{"class":78}," v-for",[37,1132,72],{"class":54},[37,1134,1135],{"class":88},"\"n in 5\"",[37,1137,1138],{"class":78}," :key",[37,1140,72],{"class":54},[37,1142,1143],{"class":88},"\"n\"",[37,1145,1069],{"class":78},[37,1147,72],{"class":54},[37,1149,1150],{"class":88},"\"skeleton__row\"",[37,1152,1102],{"class":1101},[37,1154,1020],{"class":54},[37,1156,1157,1160,1162],{"class":39,"line":656},[37,1158,1159],{"class":54},"  \u003C\u002F",[37,1161,1028],{"class":1016},[37,1163,1020],{"class":54},[37,1165,1166],{"class":39,"line":667},[37,1167,827],{"emptyLinePlaceholder":826},[37,1169,1170,1172,1174,1176,1178,1181,1183,1185],{"class":39,"line":681},[37,1171,1025],{"class":54},[37,1173,1017],{"class":1016},[37,1175,1061],{"class":50},[37,1177,72],{"class":54},[37,1179,1180],{"class":88},"\"",[37,1182,66],{"class":54},[37,1184,1180],{"class":88},[37,1186,1020],{"class":54},[37,1188,1189,1191,1194,1197,1199],{"class":39,"line":687},[37,1190,1089],{"class":54},[37,1192,1193],{"class":1016},"h1",[37,1195,1196],{"class":54},">{{ spot.name }}\u003C\u002F",[37,1198,1193],{"class":1016},[37,1200,1020],{"class":54},[37,1202,1204],{"class":39,"line":1203},13,[37,1205,1206],{"class":54},"    ...\n",[37,1208,1210,1212,1214],{"class":39,"line":1209},14,[37,1211,1159],{"class":54},[37,1213,1017],{"class":1016},[37,1215,1020],{"class":54},[37,1217,1219,1222,1224],{"class":39,"line":1218},15,[37,1220,1221],{"class":54},"\u003C\u002F",[37,1223,1017],{"class":1016},[37,1225,1020],{"class":54},[15,1227,1228,1229,1232],{},"스켈레톤의 크기를 실제 화면과 맞춘 이유는, 데이터가 도착했을 때 글과 사진이 ",[19,1230,1231],{},"아래로 밀리는 현상","을 막기 위해서다.",[336,1234,1236],{"id":1235},"요약은-확정된-뒤-한-번만-그린다","요약은 \"확정된 뒤 한 번만\" 그린다",[15,1238,1239,1240,1243],{},"처음에는 AI 요약이 오기 전까지 간단한 규칙 기반 요약을 먼저 보여주려 했다. 그런데 그러면 ",[19,1241,1242],{},"읽고 있던 글이 1~2초 뒤 AI 요약으로 갑자기 바뀐다."," 그래서 요약이 오는 동안에는 로딩 표시만 보여주고, 결과가 확정되면 한 번만 그리게 했다. AI 요약이 실패했을 때만 규칙 기반 요약으로 대신한다.",[27,1245,1247],{"className":29,"code":1246,"language":31,"meta":32,"style":32},"const summaryPending = computed(() => summaryStatus.value === 'pending')\nconst summary = computed(() => {\n  if (summaryPending.value) return '' \u002F\u002F 오는 중: 로딩 표시\n  return aiSummary.value?.summary || spot.value?.summary || '' \u002F\u002F 실패 시 규칙 기반\n})\n",[34,1248,1249,1273,1290,1306,1326],{"__ignoreMap":32},[37,1250,1251,1253,1256,1258,1260,1262,1264,1267,1269,1271],{"class":39,"line":40},[37,1252,51],{"class":50},[37,1254,1255],{"class":65}," summaryPending",[37,1257,472],{"class":50},[37,1259,806],{"class":78},[37,1261,82],{"class":54},[37,1263,85],{"class":50},[37,1265,1266],{"class":54}," summaryStatus.value ",[37,1268,816],{"class":50},[37,1270,819],{"class":88},[37,1272,104],{"class":54},[37,1274,1275,1277,1280,1282,1284,1286,1288],{"class":39,"line":47},[37,1276,51],{"class":50},[37,1278,1279],{"class":65}," summary",[37,1281,472],{"class":50},[37,1283,806],{"class":78},[37,1285,82],{"class":54},[37,1287,85],{"class":50},[37,1289,218],{"class":54},[37,1291,1292,1295,1298,1300,1303],{"class":39,"line":221},[37,1293,1294],{"class":50},"  if",[37,1296,1297],{"class":54}," (summaryPending.value) ",[37,1299,488],{"class":50},[37,1301,1302],{"class":88}," ''",[37,1304,1305],{"class":43}," \u002F\u002F 오는 중: 로딩 표시\n",[37,1307,1308,1310,1313,1316,1319,1321,1323],{"class":39,"line":256},[37,1309,259],{"class":50},[37,1311,1312],{"class":54}," aiSummary.value?.summary ",[37,1314,1315],{"class":50},"||",[37,1317,1318],{"class":54}," spot.value?.summary ",[37,1320,1315],{"class":50},[37,1322,1302],{"class":88},[37,1324,1325],{"class":43}," \u002F\u002F 실패 시 규칙 기반\n",[37,1327,1328],{"class":39,"line":271},[37,1329,274],{"class":54},[336,1331,1333],{"id":1332},"await가-없어지면-바뀌는-것","await가 없어지면 바뀌는 것",[15,1335,1336,1338,1339,1342,1343,1346,1347,1349,1350,1353,1354,1356,1357,1360,1361,1364],{},[34,1337,175],{},"를 빼면 ",[34,1340,1341],{},"setup"," 안에서 ",[34,1344,1345],{},"spot.value","를 바로 읽을 수 없다. 처음에는 비어 있기 때문이다. 원래 코드에는 ",[34,1348,1341],{},"에서 ",[34,1351,1352],{},"console.log(spot.value...)","로 응답을 찍는 부분이 있었는데, ",[34,1355,333],{},"로 바꾸면 항상 ",[34,1358,1359],{},"undefined","가 찍힌다. 데이터가 도착할 때 실행되도록 ",[34,1362,1363],{},"watch","로 옮겨야 한다.",[27,1366,1368],{"className":29,"code":1367,"language":31,"meta":32,"style":32},"watch(spot, (value) => {\n  if (!value) return\n  console.log('[상세] 받은 데이터', value)\n}, { immediate: true })\n",[34,1369,1370,1385,1399,1415],{"__ignoreMap":32},[37,1371,1372,1374,1377,1379,1381,1383],{"class":39,"line":40},[37,1373,1363],{"class":78},[37,1375,1376],{"class":54},"(spot, (",[37,1378,98],{"class":58},[37,1380,239],{"class":54},[37,1382,85],{"class":50},[37,1384,218],{"class":54},[37,1386,1387,1389,1391,1393,1396],{"class":39,"line":47},[37,1388,1294],{"class":50},[37,1390,516],{"class":54},[37,1392,600],{"class":50},[37,1394,1395],{"class":54},"value) ",[37,1397,1398],{"class":50},"return\n",[37,1400,1401,1404,1407,1409,1412],{"class":39,"line":221},[37,1402,1403],{"class":54},"  console.",[37,1405,1406],{"class":78},"log",[37,1408,207],{"class":54},[37,1410,1411],{"class":88},"'[상세] 받은 데이터'",[37,1413,1414],{"class":54},", value)\n",[37,1416,1417,1420,1422],{"class":39,"line":256},[37,1418,1419],{"class":54},"}, { immediate: ",[37,1421,265],{"class":65},[37,1423,397],{"class":54},[158,1425],{},[10,1427,130],{"id":130},[116,1429,1430,1443],{},[119,1431,1432],{},[122,1433,1434,1437,1440],{},[125,1435,1436],{},"항목",[125,1438,1439],{},"고치기 전",[125,1441,1442],{},"고친 뒤",[132,1444,1445,1456,1466],{},[122,1446,1447,1450,1453],{},[137,1448,1449],{},"목록 → 상세 클릭 후 화면이 바뀌기까지",[137,1451,1452],{},"2.4초 (이전 화면 그대로)",[137,1454,1455],{},"바로 (스켈레톤)",[122,1457,1458,1461,1464],{},[137,1459,1460],{},"상세 API 응답",[137,1462,1463],{},"AI 요약(1~2초)까지 기다림",[137,1465,695],{},[122,1467,1468,1471,1474],{},[137,1469,1470],{},"AI 요약",[137,1472,1473],{},"상세와 함께 도착",[137,1475,1476],{},"브라우저에서 따로, 도착하면 한 번만 그림",[10,1478,1479],{"id":1479},"정리",[116,1481,1482,1492],{},[119,1483,1484],{},[122,1485,1486,1489],{},[125,1487,1488],{},"상황",[125,1490,1491],{},"쓸 것",[132,1493,1494,1504,1514,1524],{},[122,1495,1496,1499],{},[137,1497,1498],{},"데이터 없이는 페이지가 의미 없고, 응답이 빠르다",[137,1500,1501,1503],{},[34,1502,150],{}," (기본)",[122,1505,1506,1509],{},[137,1507,1508],{},"응답이 느릴 수 있고, 먼저 화면을 보여주고 싶다",[137,1510,1511,1513],{},[34,1512,333],{}," + 로딩\u002F스켈레톤",[122,1515,1516,1519],{},[137,1517,1518],{},"느린 부가 정보 (AI 요약, 추천, 통계)",[137,1520,1521,1522],{},"별도 API로 분리 + ",[34,1523,954],{},[122,1525,1526,1529],{},[137,1527,1528],{},"검색엔진이 읽어야 하는 본문",[137,1530,1531,1533],{},[34,1532,954],{},"는 쓰지 않는다",[15,1535,1536,1538,1539,1542,1543,1545],{},[34,1537,150],{},"는 코드가 가장 간단해서 기본으로 쓰기 쉽다. 하지만 ",[19,1540,1541],{},"응답이 느린 순간, 그 시간만큼 페이지 이동이 통째로 멈춘다","는 걸 알고 써야 한다. 먼저 느린 부분을 응답에서 떼어 내고, 남은 대기는 ",[34,1544,402],{},"와 스켈레톤으로 사용자에게 보이게 하는 게 순서다.",[15,1547,1548,1550,1551,1554,1555,1557,1558,1563],{},[34,1549,171],{},"\u002F",[34,1552,1553],{},"useAsyncData","의 ",[34,1556,891],{},"를 잘못 정해서 생기는 문제는 ",[1559,1560,1562],"a",{"href":1561},"\u002Fko\u002Fnuxt-useasyncdata-cache-error","useAsyncData 캐싱 문제와 Key 동적 설정"," 글에 정리했다.",[10,1565,1567],{"id":1566},"참고-자료","참고 자료",[1569,1570,1571,1580,1587],"ul",{},[1572,1573,1574],"li",{},[1559,1575,1579],{"href":1576,"rel":1577},"https:\u002F\u002Fnuxt.com\u002Fdocs\u002Fapi\u002Fcomposables\u002Fuse-fetch",[1578],"nofollow","Nuxt 문서: useFetch",[1572,1581,1582],{},[1559,1583,1586],{"href":1584,"rel":1585},"https:\u002F\u002Fnuxt.com\u002Fdocs\u002Fapi\u002Fcomposables\u002Fuse-lazy-fetch",[1578],"Nuxt 문서: useLazyFetch",[1572,1588,1589],{},[1559,1590,1593],{"href":1591,"rel":1592},"https:\u002F\u002Fnuxt.com\u002Fdocs\u002Fgetting-started\u002Fdata-fetching",[1578],"Nuxt 문서: 데이터 가져오기 (lazy, server 옵션)",[1595,1596,1597],"style",{},"html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .s4XuR, html code.shiki .s4XuR{--shiki-default:#E36209;--shiki-dark:#FFAB70}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}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 .s9eBZ, html code.shiki .s9eBZ{--shiki-default:#22863A;--shiki-dark:#85E89D}html pre.shiki code .s7hpK, html code.shiki .s7hpK{--shiki-default:#B31D28;--shiki-default-font-style:italic;--shiki-dark:#FDAEB7;--shiki-dark-font-style:italic}",{"title":32,"searchDepth":47,"depth":47,"links":1599},[1600,1601,1604,1605,1606,1610,1611,1612],{"id":12,"depth":47,"text":13},{"id":162,"depth":47,"text":163,"children":1602},[1603],{"id":338,"depth":221,"text":339},{"id":440,"depth":47,"text":441},{"id":706,"depth":47,"text":707},{"id":988,"depth":47,"text":989,"children":1607},[1608,1609],{"id":1235,"depth":221,"text":1236},{"id":1332,"depth":221,"text":1333},{"id":130,"depth":47,"text":130},{"id":1479,"depth":47,"text":1479},{"id":1566,"depth":47,"text":1567},"목록에서 상세를 눌러도 2.4초 동안 화면이 그대로였다. 원인은 await useFetch와 응답에 묶인 느린 AI 호출이었다. useLazyFetch, server: false, 스켈레톤으로 고친 과정과 직접 잰 결과를 정리했다.","md",{"date":1616,"field":1617,"tags":1618},"2026.10.19","frontend",[1619,1620],"nuxt","web-performance","\u002Fko\u002Fnuxt-usefetch-await-blocks-navigation",{"title":5,"description":1613},{"loc":1621},"ko\u002Fnuxt-usefetch-await-blocks-navigation","oYU-TWmKKy45fBfbDQHFAfaXtElUMwt17m9wXihEh4E",[1627,1638,1648,1656,1663,1671,1679,1687,1694,1704,1712,1719,1730,1738,1747,1754,1760,1767,1773,1779,1787,1794,1800,1806,1812,1818,1824,1831,1837,1844,1851,1860,1868,1874,1881,1888,1894,1901,1908,1915,1918,1925,1932,1938,1947,1953,1960,1967,1973,1979,1987,1994,2002,2008,2015],{"path":1628,"title":1629,"description":1630,"meta":1631},"\u002Fko\u002Fadsense-ads-txt-and-seo-indexing-bug","애드센스 ads.txt 경고를 받고 파헤치다가 찾은 진짜 색인 버그","구글 애드센스가 ads.txt 문제를 알려왔는데, 확인해보니 파일은 멀쩡했다. 대신 서치콘솔 색인 수가 적었던 진짜 원인을 Nuxt Content 슬러그 불일치 버그에서 찾은 과정을 정리한다.",{"date":1632,"field":1633,"tags":1634},"2026.09.17","blog",[1635,1636,1637],"seo","adsense","nuxt-content",{"path":1639,"title":1640,"description":1641,"meta":1642},"\u002Fko\u002Fapi-error-response-format","API 에러 응답 형식 설계하기: 제각각인 에러 응답을 RFC 9457 Problem Details로 통일하는 법","API마다 제각각인 에러 응답을 RFC 9457 Problem Details로 통일하는 법. 필드별 검증 에러, traceId, 내부 정보 숨기기, Node.js 단일 에러 처리까지 정리했다.",{"date":1643,"field":1644,"tags":1645},"2026.10.08","backend",[1646,1647],"api","http",{"path":1649,"title":1650,"description":1651,"meta":1652},"\u002Fko\u002Fcors-guide","CORS 에러 완전 정리: 왜 막히는지부터 preflight, credentials까지 올바르게 해결하기","CORS 에러는 서버가 아니라 브라우저가 막은 것이다. 같은 출처 정책, preflight, credentials, Expose-Headers와 잘못된 해결법까지 실제 브라우저로 확인하며 정리했다.",{"date":1643,"field":1644,"tags":1653},[1647,1654,1655],"web-security","nodejs",{"path":1657,"title":1658,"description":1659,"meta":1660},"\u002Fko\u002Fcss-has-selector","CSS :has() 선택자 실전 가이드: 자바스크립트 없이 부모를 선택하는 법","체크하면 카드가 강조되고, 입력이 틀리면 폼 전체가 반응하고, 별점에 마우스를 올리면 앞의 별까지 칠해진다. 예전엔 자바스크립트가 필요했던 일을 CSS :has() 한 줄로 해결하는 실전 예제를 직접 눌러보며 정리했다.",{"date":1643,"field":1617,"tags":1661},[1662],"css",{"path":1664,"title":1665,"description":1666,"meta":1667},"\u002Fko\u002Fcss-layouts","CSS Flexbox 완전 정복 가이드","Flexbox를 활용한 반응형 레이아웃 구현 방법과 실전 예제. 수직 정렬, 네비게이션 바, 카드 레이아웃까지 완벽 정리!",{"date":1668,"image":1669,"field":1617,"tags":1670},"2025.01.25","css.jpg",[1662],{"path":1672,"title":1673,"description":1674,"meta":1675},"\u002Fko\u002Fcss-login-form","로그인","HTML과 CSS로 로그인 카드 UI를 만들어보는 예제. 라벨, 아이콘이 들어간 입력칸, 버튼을 BEM 클래스로 구성하고 결과 화면을 코드와 함께 확인할 수 있다.",{"date":1676,"field":1617,"tags":1677},"2025.03.29",[1678,1662],"html",{"path":1680,"title":1681,"description":1682,"meta":1683},"\u002Fko\u002Fcsv-parser-cleaning","복잡한 CSV 데이터를 안전하게 파싱하는 방법","JavaScript에서 큰따옴표, 줄바꿈, 쉼표 등 복잡한 CSV 데이터를 안전하게 객체로 변환하는 전체 과정 설명",{"date":1684,"field":1617,"tags":1685},"2025.06.19",[1686],"javascript",{"path":1688,"title":1689,"description":1690,"meta":1691},"\u002Fko\u002Fdebounce-guide","debounce와 throttle이란??","반복되는 함수 호출을 제어하는 기술인 디바운스(debounce)와 쓰로틀(throttle)을 알아보자.",{"date":1692,"field":1617,"tags":1693},"2025.03.26",[1686],{"path":1695,"title":1696,"description":1697,"meta":1698},"\u002Fko\u002Fdeclarative-vs-procedural-programming","선언적 프로그래밍 vs 절차형 프로그래밍","선언적 프로그래밍과 절차형 프로그래밍은 서로 대비되는 대표적인 패러다임이다. 두 패러다임의 차이를 알아보고, 각 패러다임에 해당하는 언어와 Vue\u002FReact의 특징을 살펴보자.",{"date":1699,"field":1700,"tags":1701},"2025.05.24","concepts",[1702,1006,1703],"paradigm","react",{"path":1705,"title":1706,"description":1707,"meta":1708},"\u002Fko\u002Fdesign-guide","Design-Guide","학습 서비스 EduTrack을 예로 든 웹 디자인 가이드. 색상 팔레트, 타이포그래피, 아이콘, 반응형 레이아웃과 UI 컴포넌트, 접근성까지 화면 설계 기준을 정리했다.",{"date":1709,"field":1617,"tags":1710},"2025.01.19",[1711],"design-system",{"path":1713,"title":1714,"description":1715,"meta":1716},"\u002Fko\u002Fdikw-pyramid","DIKW 피라미드 정리: 데이터가 지혜가 되기까지","Data, Information, Knowledge, Wisdom 4단계로 구성된 DIKW 피라미드 개념을 로그\u002F분석 데이터 같은 실제 개발 사례에 대입해서 정리한다.",{"date":1717,"field":1700,"tags":1718},"2026.09.18",[59],{"path":1720,"title":1721,"description":1722,"meta":1723},"\u002Fko\u002Fdisplaying-commits-with-github-actions","깃허브 액션으로 커밋 로그를 블로그에 띄우기: Nuxt와 Vercel 활용법","깃허브 액션을 통해 커밋 데이터를 자동으로 수집하고, Nuxt와 Vercel로 UI에 노출하는 방법을 소개합니다.",{"date":1724,"image":1725,"field":1726,"tags":1727},"2025.02.28","github-commits.jpg","infra",[1728,1729,1619],"github-actions","vercel",{"path":1731,"title":1732,"description":1733,"meta":1734},"\u002Fko\u002Fdocker-auto-build-run","로컬에서 커밋 시 도커 빌드 후 컨테이너 시작하기","로컬에서 커밋할 때마다 Docker 이미지를 자동으로 빌드하고 컨테이너를 다시 띄우는 방법. 셸 스크립트를 작성하고 Git 훅으로 연결하는 과정을 정리했다.",{"date":1735,"field":1726,"tags":1736},"2025.03.10",[1737],"docker",{"path":1739,"title":1740,"description":1741,"meta":1742},"\u002Fko\u002Fhow-to-mount-storage","라즈베리파이4에 저장장치 마운트 시키기","라즈베리파이에 저장장치를 연결하고 파티션 생성부터 포맷, 마운트까지의 전체 과정을 정리한 기록입니다.",{"date":1743,"field":1726,"tags":1744},"2025.07.11",[1745,1746],"raspberry-pi","linux",{"path":1748,"title":1749,"description":1750,"meta":1751},"\u002Fko\u002Fhtml","HTML이란 무엇인가","HTML의 역할과 기본 문서 구조를 정리하고, 단일 페이지, 내비게이션 포함, 그리드 레이아웃처럼 자주 쓰는 페이지 뼈대를 예제 코드로 살펴본다.",{"date":1668,"image":1752,"field":1617,"tags":1753},"html.jpg",[1678],{"path":1755,"title":1756,"description":1757,"meta":1758},"\u002Fko\u002Fhtml-features-without-javascript","자바스크립트 없이 HTML만으로 되는 것들: 아직도 div로 다 만들고 있다면","아코디언, 팝오버, 모달, 자동완성, 폼 검증, 이미지 지연 로딩까지. 라이브러리 없이 HTML 태그와 속성만으로 해결되는 기능을 예제와 함께 정리했다. 코드는 줄고 접근성은 덤으로 따라온다.",{"date":1643,"field":1617,"tags":1759},[1678],{"path":1761,"title":1762,"description":1763,"meta":1764},"\u002Fko\u002Fhtml2","미치광이 카드 컴포넌트","글리치 효과와 움직이는 도형으로 꾸민 '미치광이' 카드 컴포넌트를 HTML과 CSS 애니메이션만으로 만들어보는 예제. 결과 화면을 바로 확인할 수 있다.",{"date":1765,"field":1617,"tags":1766},"2025.03.28",[1678,1662],{"path":1768,"title":1769,"description":1770,"meta":1771},"\u002Fko\u002Fhttp-cache-control-guide","HTTP 캐시 제대로 쓰기: Cache-Control, ETag, no-cache와 no-store의 차이","no-cache는 '캐시하지 마라'가 아니다. max-age, no-cache, no-store, ETag와 304, 배포 후 옛날 화면이 보이는 원인, Vercel CDN 캐시까지 직접 확인하며 정리했다.",{"date":1643,"field":1644,"tags":1772},[1647,1729],{"path":1774,"title":1775,"description":1776,"meta":1777},"\u002Fko\u002Fhttp-status-codes-guide","HTTP 상태 코드 올바르게 쓰기: 400 vs 422, 401 vs 403, 200 vs 201 vs 204 헷갈릴 때 보는 정리","400 vs 422, 401 vs 403, 200 vs 201 vs 204처럼 헷갈리는 HTTP 상태 코드를 상황별로 정리하고, 301이 POST를 GET으로 바꾸는 리다이렉트 함정까지 다뤘다.",{"date":1643,"field":1644,"tags":1778},[1647,1646],{"path":1780,"title":1781,"description":1782,"meta":1783},"\u002Fko\u002Fhttps-guide","Let's Encrypt를 이용해서 HTTPS 적용하기","무료 인증서인 Let's Encrypt와 Certbot으로 VM에 올린 웹 서비스에 HTTPS를 적용하는 방법. 인증서 발급부터 nginx 설정, 브라우저 확인까지 단계별로 정리했다.",{"date":1784,"field":1726,"tags":1785},"2025.03.11",[1786],"https",{"path":1788,"title":1789,"description":1790,"meta":1791},"\u002Fko\u002Fiframe-auto-height-code-preview","iframe 높이 자동 조절: srcdoc과 postMessage로 코드 미리보기 만들기","블로그 코드 미리보기가 비어 나오던 버그를 고치며 Shadow DOM 대신 sandbox iframe을 고른 이유와, iframe 높이를 내용에 맞추는 법(postMessage, ResizeObserver, margin 함정)을 정리했다.",{"date":1792,"field":1617,"tags":1793},"2026.10.16",[1678,1686],{"path":1795,"title":1796,"description":1797,"meta":1798},"\u002Fko\u002Fimage-compression-png-webp-avif","블로그 이미지 용량 줄이기: PNG, WebP, AVIF 실측 비교로 스크린샷 93% 줄인 방법","휴대폰 스크린샷 3장(647KB)을 44KB로 줄인 과정. 자르기, 크기 맞추기, PNG 색 줄이기, WebP, AVIF를 품질별로 직접 재서 비교하고, picture 태그로 AVIF와 WebP를 함께 쓰는 법까지 정리했다.",{"date":1792,"field":1617,"tags":1799},[1620,1678],{"path":1801,"title":1802,"description":1803,"meta":1804},"\u002Fko\u002Fjavascript-async-error-handling","자바스크립트 비동기 에러 올바르게 처리하기: try\u002Fcatch가 못 잡는 경우부터 Promise.all vs allSettled까지","try\u002Fcatch가 비동기 에러를 못 잡는 이유, fetch의 res.ok, Promise.all vs allSettled, 반복문 속 await, 타임아웃과 요청 취소까지 비동기 에러 처리 함정을 정리했다.",{"date":1643,"field":1617,"tags":1805},[1686],{"path":1807,"title":1808,"description":1809,"meta":1810},"\u002Fko\u002Fjavascript-event-loop","자바스크립트 이벤트 루프 완전 정복: 마이크로태스크와 매크로태스크의 실행 순서","setTimeout(0)보다 Promise.then이 먼저 실행되는 이유는? 콜 스택, 태스크 큐, 마이크로태스크 큐가 어떤 순서로 돌아가는지 예제로 정리하고, 브라우저와 Node.js의 차이, 실무에서 UI 멈춤을 피하는 방법까지 알아보자.",{"date":1643,"field":1700,"tags":1811},[1686,1655],{"path":1813,"title":1814,"description":1815,"meta":1816},"\u002Fko\u002Fjavascript-higher-order-functions","자바스크립트 고차 함수 완전 정복: map, filter, reduce부터 직접 만드는 once, memoize까지","map, filter, reduce를 제대로 쓰는 법부터 once, memoize, pipe, 커링을 직접 만들어보고 map(parseInt) 같은 함정까지 자바스크립트 고차 함수를 정리했다.",{"date":1643,"field":1617,"tags":1817},[1686],{"path":1819,"title":1820,"description":1821,"meta":1822},"\u002Fko\u002Fjavascript-nullish-coalescing-optional-chaining","자바스크립트 ?? vs || 완벽 정리: null, undefined, 0, 빈 문자열을 올바르게 처리하는 법","볼륨 0이 50으로 바뀌고, 빈 닉네임이 '익명'이 되는 버그는 대부분 || 때문이다. ??와 ||의 차이, ?. 옵셔널 체이닝, ??=, 기본 매개변수가 적용되는 조건, null 검사하는 올바른 방법까지 직접 값을 넣어보며 정리했다.",{"date":1643,"field":1617,"tags":1823},[1686],{"path":1825,"title":1826,"description":1827,"meta":1828},"\u002Fko\u002Fjs-data-01","JavaScript 데이터01","배열 필터링과 변환, 합계 계산, 그룹화, 정렬, 중첩 데이터 처리, 중복 제거까지 자바스크립트로 데이터를 다루는 연습 문제를 난이도별로 풀어본다.",{"date":1829,"field":1617,"tags":1830},"2025.03.08",[1686],{"path":1832,"title":1833,"description":1834,"meta":1835},"\u002Fko\u002Fjs-data-02","JavaScript 데이터02","주문 데이터 필터링과 총액 계산, 고객별 주문 요약처럼 실무에 가까운 자바스크립트 데이터 처리 문제를 reduce 등 배열 메서드로 풀어본다.",{"date":1829,"field":1617,"tags":1836},[1686],{"path":1838,"title":1839,"description":1840,"meta":1841},"\u002Fko\u002Fjwt-vs-session-auth","JWT vs 세션 인증 비교: 무엇을 써야 할까? 저장 위치, 로그아웃, 보안까지 정리","JWT는 암호화가 아니라 서명이다. 세션과 JWT의 동작 방식, 강제 로그아웃 문제, localStorage와 httpOnly 쿠키 중 저장 위치, 리프레시 토큰까지 비교했다.",{"date":1643,"field":1644,"tags":1842},[1843,1654],"auth",{"path":1845,"title":1846,"description":1847,"meta":1848},"\u002Fko\u002Fload-more-button-pagination-seo","\"더 보기\" 버튼 페이지네이션과 SEO: 구글 크롤러는 버튼을 누르지 않는다","목록을 '더 보기' 버튼으로 바꿨더니 글 49개 중 10개만 링크로 연결돼 있었다. 구글 크롤러가 버튼을 누르지 않는 이유를 구글 문서로 확인하고, 모든 글을 \u003Ca href> 링크로 잇는 방법을 정리했다.",{"date":1849,"field":1633,"tags":1850},"2026.10.14",[1635,1678],{"path":1852,"title":1853,"description":1854,"meta":1855},"\u002Fko\u002Fmarkdown-guid","마크다운 문법","제목, 강조, 목록, 링크, 이미지, 코드 블록까지 블로그 글과 README 작성에 필요한 마크다운 문법을 예제와 함께 한 번에 정리했다.",{"date":1856,"image":1857,"field":1633,"tags":1858},"2025.03.02","markdown.webp",[1859],"markdown",{"path":1861,"title":1862,"description":1863,"meta":1864},"\u002Fko\u002Fminio-guide","MinIO 완벽 가이드: 설치부터 Node.js 연동까지","MinIO는 오픈소스 기반의 고성능 객체 스토리지 서버입니다. AWS S3와 호환되는 API를 제공하여 클라우드 네이티브 애플리케이션을 위한 완벽한 스토리지 솔루션으로 자리잡고 있습니다.",{"date":1865,"field":1644,"tags":1866},"2025.11.23",[1867,1655],"minio",{"path":1869,"title":1870,"description":1871,"meta":1872},"\u002Fko\u002Fnitro-wildcard-redirect-url-migration","글 주소 프리픽스를 통째로 바꿔야 할 때: Nitro wildcard 리다이렉트로 안전하게 옮기기","\u002Fblog\u002F[슬러그]로 쓰던 글 주소를 \u002Fko\u002F[슬러그]로 옮기면서, 기존 링크\u002F북마크를 하나도 안 깨뜨리고 처리한 방법. Nitro routeRules의 와일드카드 리다이렉트 패턴과 실제로 같이 바꿔야 했던 범위를 정리한다.",{"date":1643,"field":1633,"tags":1873},[1619,1635],{"path":1875,"title":1876,"description":1877,"meta":1878},"\u002Fko\u002Fnode-simple-server","Node.js 간단한 서버 만들기","Node.js 기본 http 모듈로 간단한 웹 서버를 만들고 실행하는 방법. 서버 코드 작성부터 Express로 라우팅을 확장하는 과정까지 정리했다.",{"date":1879,"field":1644,"tags":1880},"2025.01.30",[1655],{"path":1882,"title":1883,"description":1884,"meta":1885},"\u002Fko\u002Fnodejs-graceful-shutdown","Node.js 서버 안전하게 종료하기 (Graceful Shutdown): 배포할 때마다 요청이 끊기는 이유","배포할 때마다 요청이 끊긴다면 SIGTERM을 처리하지 않았기 때문이다. server.close(), keep-alive 함정, Docker와 PM2의 신호 전달 문제까지 실행하며 정리했다.",{"date":1643,"field":1644,"tags":1886},[1655,1737,1887],"pm2",{"path":1889,"title":1890,"description":1891,"meta":1892},"\u002Fko\u002Fnuxt-colormode","Nuxt3 다크모드 적용하기","@nuxtjs\u002Fcolor-mode로 Nuxt 3에 다크 모드를 적용하는 방법. 설정, useColorMode()와 $colorMode의 차이, 토글 버튼과 초기 테마 설정까지 정리했다.",{"date":1676,"field":1617,"tags":1893},[1619],{"path":1895,"title":1896,"description":1897,"meta":1898},"\u002Fko\u002Fnuxt-content-vercel-empty-query-sqlite","배포만 하면 블로그 글이 하나도 안 보이던 버그: Nuxt Content와 Vercel의 \u002Ftmp 문제","로컬에서는 멀쩡한데 Vercel에 올리면 queryCollection()이 빈 배열만 반환하던 버그를 추적한 과정. 원인은 @nuxt\u002Fcontent가 Vercel의 읽기 전용 파일시스템을 지원하기 전 버전에 고정돼 있었던 것.",{"date":1899,"field":1633,"tags":1900},"2026.10.07",[1637,1729],{"path":1902,"title":1903,"description":1904,"meta":1905},"\u002Fko\u002Fnuxt-runtimeconfig-appconfig","Nuxt 설정 runtimeConfig vs app.config 완전 정복","Nuxt3에서 전역 설정을 어떻게 관리하고, 어떤 기준으로 나누어야 할까? 다크모드 예시부터 실무 기준 설정 전략까지 총정리",{"date":1906,"field":1617,"tags":1907},"2025.06.16",[1619],{"path":1561,"title":1909,"description":1910,"meta":1911},"useAsyncData 캐싱 문제와 Key 동적 설정으로 해결하기","다른 글로 이동해도 이전 글 데이터가 계속 보이는 Nuxt 3 버그. useAsyncData의 key 기반 캐싱이 원인이었고, key를 동적으로 바꿔 해결한 과정을 정리했다.",{"date":1912,"field":1617,"tags":1913,"image":1914},"2025.01.24",[1619],"cache.jpg",{"path":1621,"title":5,"description":1613,"meta":1916},{"date":1616,"field":1617,"tags":1917},[1619,1620],{"path":1919,"title":1920,"description":1921,"meta":1922},"\u002Fko\u002Fnuxt-vercel-sql-error","Nuxt 3에서 Vercel 배포 시 발생한 md 파일 로딩 문제 해결기","Nuxt 3 웹 어플리케이션에서 Vercel 배포 환경에서 발생한 md 파일 로딩 문제를 분석하고 해결한 방법에 대해 공유합니다.",{"date":1912,"image":1923,"field":1617,"tags":1924},"ssg.jpg",[1619,1637,1729],{"path":1926,"title":1927,"description":1928,"meta":1929},"\u002Fko\u002Fnuxt3-pinia-guide","nuxt3 Pinia 적용하기","Nuxt 3 프로젝트에 @pinia\u002Fnuxt로 Pinia를 설치하고 스토어를 만드는 방법. 상태 값 읽기, 액션으로 값 바꾸기까지 예제로 정리했다.",{"date":1676,"field":1617,"tags":1930},[1619,1931],"pinia",{"path":1933,"title":1934,"description":1935,"meta":1936},"\u002Fko\u002Fnuxt3-seo-setup","Nuxt 3 SEO 설정 정리: sitemap, canonical, hreflang, 구조화 데이터(JSON-LD)","Nuxt 3와 Nuxt Content 블로그에 실제로 적용한 SEO 설정을 코드로 정리했다. 사이트맵 lastmod, canonical과 필터 주소 noindex, 한\u002F영 hreflang, JSON-LD 날짜 형식, prerender까지.",{"date":1849,"field":1633,"tags":1937},[1635,1619],{"path":1939,"title":1940,"description":1941,"meta":1942},"\u002Fko\u002Fnuxt3-unit-test","Nuxt 프로젝트에 유닛 테스트 코드 추가하기","Nuxt 3 프로젝트에서 Vitest를 활용한 테스트 환경 설정과 유틸리티 함수 테스트 방법",{"date":1943,"image":1944,"field":1617,"tags":1945},"2025.03.07","unit-test.jpg",[1619,1946],"vitest",{"path":1948,"title":1949,"description":1950,"meta":1951},"\u002Fko\u002Fpm2-guide","프로세스 매니저 PM2","Node.js 배포 환경에서 쓰는 프로세스 매니저 PM2. 설치와 실행부터 프로세스 목록, 재시작, 로그 확인, 모니터링까지 자주 쓰는 명령어를 정리했다.",{"date":1735,"field":1726,"tags":1952},[1887,1655],{"path":1954,"title":1955,"description":1956,"meta":1957},"\u002Fko\u002Freact-createportal","React createPortal 완벽 가이드","React의 `createPortal`을 활용한 UI 구현법, 활용 사례, 장단점 및 코드 예제를 소개합니다.",{"date":1958,"field":1617,"tags":1959},"2025.01.27",[1703],{"path":1961,"title":1962,"description":1963,"meta":1964},"\u002Fko\u002Frouting","Routing","Nuxt file-system routing creates a route for every file in the pages\u002F directory.",{"date":1965,"field":1617,"tags":1966},"2025.01.22",[1619],{"path":1968,"title":1969,"description":1970,"meta":1971},"\u002Fko\u002Fsearch-console-discovered-crawled-not-indexed","구글 서치 콘솔 \"발견됨 \u002F 크롤링됨 - 현재 색인이 생성되지 않음\" 차이와 확인할 것","서치 콘솔의 '발견됨 - 현재 색인이 생성되지 않음'과 '크롤링됨 - 현재 색인이 생성되지 않음'은 멈춘 단계가 다르다. 두 상태의 뜻과 각각 확인할 것, 보고서와 site: 숫자가 다른 이유까지 정리했다.",{"date":1849,"field":1633,"tags":1972},[1635],{"path":1974,"title":1975,"description":1976,"meta":1977},"\u002Fko\u002Fsemantic-html-common-mistakes","의미 있는 HTML 쓰기: 대부분이 하는 시맨틱 HTML 실수 7가지","화면에서는 똑같아 보여도 div로 만든 버튼, label 없는 입력칸, 크기로 고른 제목 태그는 키보드 사용자와 스크린 리더, 검색 엔진에게 전혀 다르게 보인다. 직접 눌러볼 수 있는 예제로 흔한 시맨틱 HTML 실수와 고치는 법을 정리했다.",{"date":1643,"field":1617,"tags":1978},[1678],{"path":1980,"title":1981,"description":1982,"meta":1983},"\u002Fko\u002Ftanstack-query-guide","TanStack Query란 무엇인가?","TanStack Query가 웹 애플리케이션에서 데이터 가져오기, 캐싱, 상태 관리를 어떻게 개선하는지 알아본다.",{"date":1984,"field":1617,"tags":1985},"2025.04.15",[1703,1986],"tanstack-query",{"path":1988,"title":1989,"description":1990,"meta":1991},"\u002Fko\u002Fuse-context","리엑트 상태관리 useContext()","React에서 `useContext`를 사용하면 컴포넌트 트리에 깊이 중첩된 컴포넌트에서도 prop drilling 없이 상태를 공유할 수 있습니다. 이 글에서는 `useContext`의 개념, 사용 방법, 장단점, 그리고 실전 예제를 함께 알아보겠습니다.",{"date":1992,"field":1617,"tags":1993},"2025.02.03",[1703],{"path":1995,"title":1996,"description":1997,"meta":1998},"\u002Fko\u002Fvite-plugin-style-inject","리엑티 컴포넌트를 패키지 빌드 시 CSS 같이 적용시키기","React 컴포넌트를 Vite 라이브러리 모드로 빌드하면 CSS가 적용되지 않는 문제. 원인을 분석하고 vite-plugin-lib-inject-css로 자동 주입해 해결했다.",{"date":1999,"field":1617,"tags":2000},"2025.04.06",[2001,1703],"vite",{"path":2003,"title":2004,"description":2005,"meta":2006},"\u002Fko\u002Fvue-component-guide","Vue의 \u003Ccomponent :is \u002F> 완벽 정리: 동적 렌더링의 모든 것","Vue에서 \u003Ccomponent :is \u002F>를 활용한 동적 컴포넌트 렌더링 방법과 VNode, 컴포넌트 객체의 차이를 실전 예제로 이해하기",{"date":1668,"field":1617,"tags":2007},[1006],{"path":2009,"title":2010,"description":2011,"meta":2012},"\u002Fko\u002Fvue-query-ref-value-trap-nuxt3","Vue Query에서 데이터가 안 보이는 이유? Nuxt 3와 Ref 구조의 함정","Nuxt 3 + vue-query를 사용할 때 API 데이터가 `v-if` 조건문에서 제대로 표시되지 않는 현상을 해결한 경험을 바탕으로, Ref 구조와 template 디렉티브에서의 차이를 자세히 설명합니다.",{"date":2013,"field":1617,"tags":2014},"2025.06.08",[1619,1006,1986],{"path":2016,"title":2017,"description":2018,"meta":2019},"\u002Fko\u002Fweb-security-sql-injection-xss-csrf","웹 보안 기본 3대 공격: SQL Injection, XSS, CSRF 원리와 방어법","로그인 폼 한 줄로 관리자가 되고 댓글 하나로 스크립트가 실행된다. SQL Injection, XSS, CSRF의 원리를 직접 확인하고 각각을 막는 방법을 정리했다.",{"date":2020,"field":1644,"tags":2021},"2026.10.09",[1654,1655],1792407002030]