[{"data":1,"prerenderedAt":1691},["ShallowReactive",2],{"blog-post-\u002Fko\u002Ftanstack-query-guide":3,"blog-related-source":1431},{"id":4,"title":5,"body":6,"description":1418,"extension":1419,"meta":1420,"navigation":135,"path":1426,"seo":1427,"sitemap":1428,"stem":1429,"__hash__":1430},"ko\u002Fko\u002Ftanstack-query-guide.md","TanStack Query란 무엇인가?",{"type":7,"value":8,"toc":1407},"minimark",[9,13,19,27,36,39,48,56,61,64,89,97,104,238,244,249,259,678,682,908,914,1058,1061,1100,1103,1107,1113,1253,1257,1388,1390,1403],[10,11,12],"p",{},"요즘 프론트엔드 구직시장에 요구사항으로 항상 써져있는 문구가 있다",[10,14,15],{},[16,17,18],"code",{},"tanstack-query 사용 가능자!!!",[10,20,21,22,26],{},"tanstack-query는 ",[23,24,25],"strong",{},"서버 상태를 클라이언트에서 효율적으로 가져오고, 캐싱하고, 동기화하며 관리할 수 있는 도구","이다.",[10,28,29],{},[23,30,31,32,35],{},"한마디로 ",[16,33,34],{},"서버 상태 관리","에 특화된 라이브러리!",[10,37,38],{},"뭐길래 요래 유명한지 한번 알아보자",[40,41,42],"warning",{},[43,44,45],"blockquote",{},[10,46,47],{},"TanStack Query (formerly known as React Query) is often described as the missing data-fetching library for web applications, but in more technical terms, it makes fetching, caching, synchronizing and updating server state in your web applications a breeze.",[49,50,51],"tip",{},[43,52,53],{},[10,54,55],{},"TanStack Query(예전 이름 React Query)는 웹 앱에서 데이터를 가져오는 데 필요한 라이브러리라고 흔히 말하는데, 좀 더 기술적으로 말하면 서버 상태를 가져오고, 캐싱하고, 동기화하고, 업데이트하는 걸 엄청 쉽게 만들어준다.",[57,58,60],"h2",{"id":59},"설치-방법","설치 방법",[10,62,63],{},"@tanstack\u002Freact-query 를 설치해준다",[65,66,71],"pre",{"className":67,"code":68,"language":69,"meta":70,"style":70},"language-bash shiki shiki-themes github-light github-dark","npm i @tanstack\u002Freact-query\n","bash","",[16,72,73],{"__ignoreMap":70},[74,75,78,82,86],"span",{"class":76,"line":77},"line",1,[74,79,81],{"class":80},"sScJk","npm",[74,83,85],{"class":84},"sZZnC"," i",[74,87,88],{"class":84}," @tanstack\u002Freact-query\n",[57,90,92,93,96],{"id":91},"사용방법-usequery-데이터-가져오기","사용방법 ",[16,94,95],{},"useQuery"," - 데이터 가져오기",[10,98,99,100,103],{},"모든 라이브러리들이 그렇듯 최상위 컴포넌트에서 앱을 감싸주면 된다",[101,102],"br",{},"\n패키지를 다룰 때 이 패키지를 순수 프레임워크로만 만든다고 생각하면 너무나 당연한 절차다",[65,105,109],{"className":106,"code":107,"language":108,"meta":70,"style":70},"language-tsx shiki shiki-themes github-light github-dark","import { QueryClient, QueryClientProvider } from \"@tanstack\u002Freact-query\";\n\nconst queryClient = new QueryClient();\n\nfunction App() {\n  return (\n    \u003CQueryClientProvider client={queryClient}>\n      \u003CYourApp \u002F>\n    \u003C\u002FQueryClientProvider>\n  );\n}\n","tsx",[16,110,111,130,137,159,164,176,185,203,215,226,232],{"__ignoreMap":70},[74,112,113,117,121,124,127],{"class":76,"line":77},[74,114,116],{"class":115},"szBVR","import",[74,118,120],{"class":119},"sVt8B"," { QueryClient, QueryClientProvider } ",[74,122,123],{"class":115},"from",[74,125,126],{"class":84}," \"@tanstack\u002Freact-query\"",[74,128,129],{"class":119},";\n",[74,131,133],{"class":76,"line":132},2,[74,134,136],{"emptyLinePlaceholder":135},true,"\n",[74,138,140,143,147,150,153,156],{"class":76,"line":139},3,[74,141,142],{"class":115},"const",[74,144,146],{"class":145},"sj4cs"," queryClient",[74,148,149],{"class":115}," =",[74,151,152],{"class":115}," new",[74,154,155],{"class":80}," QueryClient",[74,157,158],{"class":119},"();\n",[74,160,162],{"class":76,"line":161},4,[74,163,136],{"emptyLinePlaceholder":135},[74,165,167,170,173],{"class":76,"line":166},5,[74,168,169],{"class":115},"function",[74,171,172],{"class":80}," App",[74,174,175],{"class":119},"() {\n",[74,177,179,182],{"class":76,"line":178},6,[74,180,181],{"class":115},"  return",[74,183,184],{"class":119}," (\n",[74,186,188,191,194,197,200],{"class":76,"line":187},7,[74,189,190],{"class":119},"    \u003C",[74,192,193],{"class":145},"QueryClientProvider",[74,195,196],{"class":80}," client",[74,198,199],{"class":115},"=",[74,201,202],{"class":119},"{queryClient}>\n",[74,204,206,209,212],{"class":76,"line":205},8,[74,207,208],{"class":119},"      \u003C",[74,210,211],{"class":145},"YourApp",[74,213,214],{"class":119}," \u002F>\n",[74,216,218,221,223],{"class":76,"line":217},9,[74,219,220],{"class":119},"    \u003C\u002F",[74,222,193],{"class":145},[74,224,225],{"class":119},">\n",[74,227,229],{"class":76,"line":228},10,[74,230,231],{"class":119},"  );\n",[74,233,235],{"class":76,"line":234},11,[74,236,237],{"class":119},"}\n",[10,239,240,241,243],{},"기존에 특정 API를 useHook으로 만들어서 사용하고 있었는데",[101,242],{},"\n이 파일의 코드에 한번 tanstack-query를 적용해보자",[245,246,248],"h3",{"id":247},"변경-전","변경 전",[250,251,252,256],"ul",{},[253,254,255],"li",{},"useEffect로 API 호출",[253,257,258],{},"데이터, 로딩 상태, 에러를 반환",[65,260,262],{"className":106,"code":261,"language":108,"meta":70,"style":70},"import { useState, useEffect } from \"react\";\nimport { Content } from \"@\u002Ftypes\u002Findex\";\nimport api from \"@\u002Fapi\u002Fconfig\";\n\nconst useFetchContents = () => {\n  const [contents, setContents] = useState\u003CContent[]>([]);\n  const [loading, setLoading] = useState\u003Cboolean>(true);\n  const [error, setError] = useState\u003Cany | null>(null);\n\n  useEffect(() => {\n    const fetch = async () => {\n      try {\n        const { data } = await api.get\u003CContent[]>(\"\u002Fassignments\");\n        setContents(data);\n      } catch (err: any) {\n        setError(err.response?.data?.error || err.message);\n      } finally {\n        setLoading(false);\n      }\n    };\n\n    fetch();\n  }, []);\n\n  return {\n    data: contents,\n    loading,\n    error,\n  };\n};\n\nexport default useFetchContents;\n",[16,263,264,278,292,306,310,328,362,396,434,438,450,469,477,515,524,549,564,574,588,594,600,605,613,619,624,631,637,643,649,655,661,666],{"__ignoreMap":70},[74,265,266,268,271,273,276],{"class":76,"line":77},[74,267,116],{"class":115},[74,269,270],{"class":119}," { useState, useEffect } ",[74,272,123],{"class":115},[74,274,275],{"class":84}," \"react\"",[74,277,129],{"class":119},[74,279,280,282,285,287,290],{"class":76,"line":132},[74,281,116],{"class":115},[74,283,284],{"class":119}," { Content } ",[74,286,123],{"class":115},[74,288,289],{"class":84}," \"@\u002Ftypes\u002Findex\"",[74,291,129],{"class":119},[74,293,294,296,299,301,304],{"class":76,"line":139},[74,295,116],{"class":115},[74,297,298],{"class":119}," api ",[74,300,123],{"class":115},[74,302,303],{"class":84}," \"@\u002Fapi\u002Fconfig\"",[74,305,129],{"class":119},[74,307,308],{"class":76,"line":161},[74,309,136],{"emptyLinePlaceholder":135},[74,311,312,314,317,319,322,325],{"class":76,"line":166},[74,313,142],{"class":115},[74,315,316],{"class":80}," useFetchContents",[74,318,149],{"class":115},[74,320,321],{"class":119}," () ",[74,323,324],{"class":115},"=>",[74,326,327],{"class":119}," {\n",[74,329,330,333,336,339,342,345,348,350,353,356,359],{"class":76,"line":178},[74,331,332],{"class":115},"  const",[74,334,335],{"class":119}," [",[74,337,338],{"class":145},"contents",[74,340,341],{"class":119},", ",[74,343,344],{"class":145},"setContents",[74,346,347],{"class":119},"] ",[74,349,199],{"class":115},[74,351,352],{"class":80}," useState",[74,354,355],{"class":119},"\u003C",[74,357,358],{"class":80},"Content",[74,360,361],{"class":119},"[]>([]);\n",[74,363,364,366,368,371,373,376,378,380,382,384,387,390,393],{"class":76,"line":187},[74,365,332],{"class":115},[74,367,335],{"class":119},[74,369,370],{"class":145},"loading",[74,372,341],{"class":119},[74,374,375],{"class":145},"setLoading",[74,377,347],{"class":119},[74,379,199],{"class":115},[74,381,352],{"class":80},[74,383,355],{"class":119},[74,385,386],{"class":145},"boolean",[74,388,389],{"class":119},">(",[74,391,392],{"class":145},"true",[74,394,395],{"class":119},");\n",[74,397,398,400,402,405,407,410,412,414,416,418,421,424,427,429,432],{"class":76,"line":205},[74,399,332],{"class":115},[74,401,335],{"class":119},[74,403,404],{"class":145},"error",[74,406,341],{"class":119},[74,408,409],{"class":145},"setError",[74,411,347],{"class":119},[74,413,199],{"class":115},[74,415,352],{"class":80},[74,417,355],{"class":119},[74,419,420],{"class":145},"any",[74,422,423],{"class":115}," |",[74,425,426],{"class":145}," null",[74,428,389],{"class":119},[74,430,431],{"class":145},"null",[74,433,395],{"class":119},[74,435,436],{"class":76,"line":217},[74,437,136],{"emptyLinePlaceholder":135},[74,439,440,443,446,448],{"class":76,"line":228},[74,441,442],{"class":80},"  useEffect",[74,444,445],{"class":119},"(() ",[74,447,324],{"class":115},[74,449,327],{"class":119},[74,451,452,455,458,460,463,465,467],{"class":76,"line":234},[74,453,454],{"class":115},"    const",[74,456,457],{"class":80}," fetch",[74,459,149],{"class":115},[74,461,462],{"class":115}," async",[74,464,321],{"class":119},[74,466,324],{"class":115},[74,468,327],{"class":119},[74,470,472,475],{"class":76,"line":471},12,[74,473,474],{"class":115},"      try",[74,476,327],{"class":119},[74,478,480,483,486,489,492,494,497,500,503,505,507,510,513],{"class":76,"line":479},13,[74,481,482],{"class":115},"        const",[74,484,485],{"class":119}," { ",[74,487,488],{"class":145},"data",[74,490,491],{"class":119}," } ",[74,493,199],{"class":115},[74,495,496],{"class":115}," await",[74,498,499],{"class":119}," api.",[74,501,502],{"class":80},"get",[74,504,355],{"class":119},[74,506,358],{"class":80},[74,508,509],{"class":119},"[]>(",[74,511,512],{"class":84},"\"\u002Fassignments\"",[74,514,395],{"class":119},[74,516,518,521],{"class":76,"line":517},14,[74,519,520],{"class":80},"        setContents",[74,522,523],{"class":119},"(data);\n",[74,525,527,530,533,536,540,543,546],{"class":76,"line":526},15,[74,528,529],{"class":119},"      } ",[74,531,532],{"class":115},"catch",[74,534,535],{"class":119}," (",[74,537,539],{"class":538},"s4XuR","err",[74,541,542],{"class":115},":",[74,544,545],{"class":145}," any",[74,547,548],{"class":119},") {\n",[74,550,552,555,558,561],{"class":76,"line":551},16,[74,553,554],{"class":80},"        setError",[74,556,557],{"class":119},"(err.response?.data?.error ",[74,559,560],{"class":115},"||",[74,562,563],{"class":119}," err.message);\n",[74,565,567,569,572],{"class":76,"line":566},17,[74,568,529],{"class":119},[74,570,571],{"class":115},"finally",[74,573,327],{"class":119},[74,575,577,580,583,586],{"class":76,"line":576},18,[74,578,579],{"class":80},"        setLoading",[74,581,582],{"class":119},"(",[74,584,585],{"class":145},"false",[74,587,395],{"class":119},[74,589,591],{"class":76,"line":590},19,[74,592,593],{"class":119},"      }\n",[74,595,597],{"class":76,"line":596},20,[74,598,599],{"class":119},"    };\n",[74,601,603],{"class":76,"line":602},21,[74,604,136],{"emptyLinePlaceholder":135},[74,606,608,611],{"class":76,"line":607},22,[74,609,610],{"class":80},"    fetch",[74,612,158],{"class":119},[74,614,616],{"class":76,"line":615},23,[74,617,618],{"class":119},"  }, []);\n",[74,620,622],{"class":76,"line":621},24,[74,623,136],{"emptyLinePlaceholder":135},[74,625,627,629],{"class":76,"line":626},25,[74,628,181],{"class":115},[74,630,327],{"class":119},[74,632,634],{"class":76,"line":633},26,[74,635,636],{"class":119},"    data: contents,\n",[74,638,640],{"class":76,"line":639},27,[74,641,642],{"class":119},"    loading,\n",[74,644,646],{"class":76,"line":645},28,[74,647,648],{"class":119},"    error,\n",[74,650,652],{"class":76,"line":651},29,[74,653,654],{"class":119},"  };\n",[74,656,658],{"class":76,"line":657},30,[74,659,660],{"class":119},"};\n",[74,662,664],{"class":76,"line":663},31,[74,665,136],{"emptyLinePlaceholder":135},[74,667,669,672,675],{"class":76,"line":668},32,[74,670,671],{"class":115},"export",[74,673,674],{"class":115}," default",[74,676,677],{"class":119}," useFetchContents;\n",[245,679,681],{"id":680},"변경-후","변경 후",[65,683,685],{"className":106,"code":684,"language":108,"meta":70,"style":70},"import { useQuery } from \"@tanstack\u002Freact-query\";\nimport { Content } from \"@\u002Ftypes\u002Findex\";\nimport api from \"@\u002Fapi\u002Fconfig\";\n\nconst useFetchContents = () => {\n  const { data, isLoading, error } = useQuery\u003CContent[], Error>({\n    queryKey: [\"contents\"], \u002F\u002F Unique key for the query\n    queryFn: async () => {\n      const { data } = await api.get\u003CContent[]>(\"\u002Fassignments\");\n      return data;\n    },\n  });\n\n  return {\n    data: data ?? [],\n    loading: isLoading,\n    error,\n  };\n};\n\nexport default useFetchContents;\n",[16,686,687,700,712,724,728,742,779,794,811,840,848,853,858,862,868,879,884,888,892,896,900],{"__ignoreMap":70},[74,688,689,691,694,696,698],{"class":76,"line":77},[74,690,116],{"class":115},[74,692,693],{"class":119}," { useQuery } ",[74,695,123],{"class":115},[74,697,126],{"class":84},[74,699,129],{"class":119},[74,701,702,704,706,708,710],{"class":76,"line":132},[74,703,116],{"class":115},[74,705,284],{"class":119},[74,707,123],{"class":115},[74,709,289],{"class":84},[74,711,129],{"class":119},[74,713,714,716,718,720,722],{"class":76,"line":139},[74,715,116],{"class":115},[74,717,298],{"class":119},[74,719,123],{"class":115},[74,721,303],{"class":84},[74,723,129],{"class":119},[74,725,726],{"class":76,"line":161},[74,727,136],{"emptyLinePlaceholder":135},[74,729,730,732,734,736,738,740],{"class":76,"line":166},[74,731,142],{"class":115},[74,733,316],{"class":80},[74,735,149],{"class":115},[74,737,321],{"class":119},[74,739,324],{"class":115},[74,741,327],{"class":119},[74,743,744,746,748,750,752,755,757,759,761,763,766,768,770,773,776],{"class":76,"line":178},[74,745,332],{"class":115},[74,747,485],{"class":119},[74,749,488],{"class":145},[74,751,341],{"class":119},[74,753,754],{"class":145},"isLoading",[74,756,341],{"class":119},[74,758,404],{"class":145},[74,760,491],{"class":119},[74,762,199],{"class":115},[74,764,765],{"class":80}," useQuery",[74,767,355],{"class":119},[74,769,358],{"class":80},[74,771,772],{"class":119},"[], ",[74,774,775],{"class":80},"Error",[74,777,778],{"class":119},">({\n",[74,780,781,784,787,790],{"class":76,"line":187},[74,782,783],{"class":119},"    queryKey: [",[74,785,786],{"class":84},"\"contents\"",[74,788,789],{"class":119},"], ",[74,791,793],{"class":792},"sJ8bj","\u002F\u002F Unique key for the query\n",[74,795,796,799,802,805,807,809],{"class":76,"line":205},[74,797,798],{"class":80},"    queryFn",[74,800,801],{"class":119},": ",[74,803,804],{"class":115},"async",[74,806,321],{"class":119},[74,808,324],{"class":115},[74,810,327],{"class":119},[74,812,813,816,818,820,822,824,826,828,830,832,834,836,838],{"class":76,"line":217},[74,814,815],{"class":115},"      const",[74,817,485],{"class":119},[74,819,488],{"class":145},[74,821,491],{"class":119},[74,823,199],{"class":115},[74,825,496],{"class":115},[74,827,499],{"class":119},[74,829,502],{"class":80},[74,831,355],{"class":119},[74,833,358],{"class":80},[74,835,509],{"class":119},[74,837,512],{"class":84},[74,839,395],{"class":119},[74,841,842,845],{"class":76,"line":228},[74,843,844],{"class":115},"      return",[74,846,847],{"class":119}," data;\n",[74,849,850],{"class":76,"line":234},[74,851,852],{"class":119},"    },\n",[74,854,855],{"class":76,"line":471},[74,856,857],{"class":119},"  });\n",[74,859,860],{"class":76,"line":479},[74,861,136],{"emptyLinePlaceholder":135},[74,863,864,866],{"class":76,"line":517},[74,865,181],{"class":115},[74,867,327],{"class":119},[74,869,870,873,876],{"class":76,"line":526},[74,871,872],{"class":119},"    data: data ",[74,874,875],{"class":115},"??",[74,877,878],{"class":119}," [],\n",[74,880,881],{"class":76,"line":551},[74,882,883],{"class":119},"    loading: isLoading,\n",[74,885,886],{"class":76,"line":566},[74,887,648],{"class":119},[74,889,890],{"class":76,"line":576},[74,891,654],{"class":119},[74,893,894],{"class":76,"line":590},[74,895,660],{"class":119},[74,897,898],{"class":76,"line":596},[74,899,136],{"emptyLinePlaceholder":135},[74,901,902,904,906],{"class":76,"line":602},[74,903,671],{"class":115},[74,905,674],{"class":115},[74,907,677],{"class":119},[10,909,910,911,913],{},"기존 커스텀 훅 파일에 적용을 해서 불필요한 리턴을 하고 있는데,",[101,912],{},"\n간단한 구조라면 아래처럼 컴포넌트에서 직접 사용하는 것도 가능하다",[65,915,917],{"className":106,"code":916,"language":108,"meta":70,"style":70},"const MyComponent = () => {\n  const { data, isLoading, error } = useQuery\u003CContent[], Error>({\n    queryKey: [\"contents\"], \u002F\u002F Unique key for the query\n    queryFn: async () => {\n      const { data } = await api.get\u003CContent[]>(\"\u002Fassignments\");\n      return data;\n    },\n  });\n\n  return \u003Cdiv>my-component\u003C\u002Fdiv>\n};\n",[16,918,919,934,966,976,990,1018,1024,1028,1032,1036,1054],{"__ignoreMap":70},[74,920,921,923,926,928,930,932],{"class":76,"line":77},[74,922,142],{"class":115},[74,924,925],{"class":80}," MyComponent",[74,927,149],{"class":115},[74,929,321],{"class":119},[74,931,324],{"class":115},[74,933,327],{"class":119},[74,935,936,938,940,942,944,946,948,950,952,954,956,958,960,962,964],{"class":76,"line":132},[74,937,332],{"class":115},[74,939,485],{"class":119},[74,941,488],{"class":145},[74,943,341],{"class":119},[74,945,754],{"class":145},[74,947,341],{"class":119},[74,949,404],{"class":145},[74,951,491],{"class":119},[74,953,199],{"class":115},[74,955,765],{"class":80},[74,957,355],{"class":119},[74,959,358],{"class":80},[74,961,772],{"class":119},[74,963,775],{"class":80},[74,965,778],{"class":119},[74,967,968,970,972,974],{"class":76,"line":139},[74,969,783],{"class":119},[74,971,786],{"class":84},[74,973,789],{"class":119},[74,975,793],{"class":792},[74,977,978,980,982,984,986,988],{"class":76,"line":161},[74,979,798],{"class":80},[74,981,801],{"class":119},[74,983,804],{"class":115},[74,985,321],{"class":119},[74,987,324],{"class":115},[74,989,327],{"class":119},[74,991,992,994,996,998,1000,1002,1004,1006,1008,1010,1012,1014,1016],{"class":76,"line":166},[74,993,815],{"class":115},[74,995,485],{"class":119},[74,997,488],{"class":145},[74,999,491],{"class":119},[74,1001,199],{"class":115},[74,1003,496],{"class":115},[74,1005,499],{"class":119},[74,1007,502],{"class":80},[74,1009,355],{"class":119},[74,1011,358],{"class":80},[74,1013,509],{"class":119},[74,1015,512],{"class":84},[74,1017,395],{"class":119},[74,1019,1020,1022],{"class":76,"line":178},[74,1021,844],{"class":115},[74,1023,847],{"class":119},[74,1025,1026],{"class":76,"line":187},[74,1027,852],{"class":119},[74,1029,1030],{"class":76,"line":205},[74,1031,857],{"class":119},[74,1033,1034],{"class":76,"line":217},[74,1035,136],{"emptyLinePlaceholder":135},[74,1037,1038,1040,1043,1047,1050,1052],{"class":76,"line":228},[74,1039,181],{"class":115},[74,1041,1042],{"class":119}," \u003C",[74,1044,1046],{"class":1045},"s9eBZ","div",[74,1048,1049],{"class":119},">my-component\u003C\u002F",[74,1051,1046],{"class":1045},[74,1053,225],{"class":119},[74,1055,1056],{"class":76,"line":234},[74,1057,660],{"class":119},[10,1059,1060],{},"코드가 많이 간결해졌다",[250,1062,1063,1069,1081,1090],{},[253,1064,1065,1066,1068],{},"데이터를 가져올 때는 TanStack Query의 ",[16,1067,95],{}," 훅을 사용한다.",[253,1070,1071,1073,1074,341,1077,1080],{},[16,1072,95],{},"는 데이터, ",[16,1075,1076],{},"로딩 상태(isLoading)",[16,1078,1079],{},"에러(error)","를 반환하므로 직관적이고 효율적이다.",[253,1082,1083,1086,1087],{},[16,1084,1085],{},"queryKey",": 쿼리를 고유하게 식별하는 키다. 배열 형태로 지정하며, 이를 통해 캐싱과 데이터 관리를 최적화한다. ",[16,1088,1089],{},"동일한 키일 경우 캐시된 데이터를 재사용한다.",[253,1091,1092,1095,1096,1099],{},[16,1093,1094],{},"queryFn",": 데이터를 실제로 가져오는 ",[16,1097,1098],{},"비동기 함수","다. 이 예제에서는 API 호출을 통해 데이터를 가져오며, 반환된 데이터는 useQuery가 관리한다.",[1101,1102],"hr",{},[57,1104,1106],{"id":1105},"usequery-옵션-정리-with-default-값","useQuery 옵션 정리 (with default 값)",[10,1108,1109,1110,1112],{},"실무에서는 쿼리의 동작을 상황에 맞게 조절해야 할 때가 많다.",[101,1111],{},"\n그럴 때 사용되는 주요 옵션들과 기본값을 함께 정리해보자.",[1114,1115,1116,1132],"table",{},[1117,1118,1119],"thead",{},[1120,1121,1122,1126,1129],"tr",{},[1123,1124,1125],"th",{},"옵션",[1123,1127,1128],{},"설명",[1123,1130,1131],{},"기본값",[1133,1134,1135,1150,1165,1181,1195,1210,1225,1238],"tbody",{},[1120,1136,1137,1143,1146],{},[1138,1139,1140],"td",{},[16,1141,1142],{},"enabled",[1138,1144,1145],{},"조건부로 쿼리 실행 여부를 제어",[1138,1147,1148],{},[16,1149,392],{},[1120,1151,1152,1157,1160],{},[1138,1153,1154],{},[16,1155,1156],{},"staleTime",[1138,1158,1159],{},"데이터가 stale로 간주되기까지 걸리는 시간(ms)",[1138,1161,1162],{},[16,1163,1164],{},"0",[1120,1166,1167,1172,1175],{},[1138,1168,1169],{},[16,1170,1171],{},"cacheTime",[1138,1173,1174],{},"unmount 후에도 데이터를 유지하는 시간(ms)",[1138,1176,1177,1180],{},[16,1178,1179],{},"300000"," (5분)",[1120,1182,1183,1188,1191],{},[1138,1184,1185],{},[16,1186,1187],{},"refetchOnWindowFocus",[1138,1189,1190],{},"창이 다시 포커스될 때 refetch",[1138,1192,1193],{},[16,1194,392],{},[1120,1196,1197,1202,1205],{},[1138,1198,1199],{},[16,1200,1201],{},"retry",[1138,1203,1204],{},"요청 실패 시 재시도 횟수",[1138,1206,1207],{},[16,1208,1209],{},"3",[1120,1211,1212,1217,1220],{},[1138,1213,1214],{},[16,1215,1216],{},"refetchInterval",[1138,1218,1219],{},"일정 주기로 refetch (ms 단위)",[1138,1221,1222,1224],{},[16,1223,585],{}," (사용 안 함)",[1120,1226,1227,1232,1235],{},[1138,1228,1229],{},[16,1230,1231],{},"select",[1138,1233,1234],{},"쿼리 결과를 변형할 수 있는 함수",[1138,1236,1237],{},"없음",[1120,1239,1240,1248,1251],{},[1138,1241,1242,341,1245],{},[16,1243,1244],{},"onSuccess",[16,1246,1247],{},"onError",[1138,1249,1250],{},"쿼리 성공\u002F실패 시 실행되는 콜백",[1138,1252,1237],{},[245,1254,1256],{"id":1255},"예시","✨ 예시",[65,1258,1260],{"className":106,"code":1259,"language":108,"meta":70,"style":70},"const { data, isLoading } = useQuery({\n  queryKey: [\"todos\"],\n  queryFn: fetchTodos,\n  enabled: !!userId, \u002F\u002F 조건부 실행\n  staleTime: 1000 * 60 * 5, \u002F\u002F 5분 간 fresh\n  cacheTime: 1000 * 60 * 10, \u002F\u002F 10분 동안 메모리 유지\n  refetchOnWindowFocus: false, \u002F\u002F 창 포커스 시 refetch 안함\n  retry: 2, \u002F\u002F 실패 시 2회까지 재시도\n});\n",[16,1261,1262,1283,1294,1299,1313,1337,1358,1370,1383],{"__ignoreMap":70},[74,1263,1264,1266,1268,1270,1272,1274,1276,1278,1280],{"class":76,"line":77},[74,1265,142],{"class":115},[74,1267,485],{"class":119},[74,1269,488],{"class":145},[74,1271,341],{"class":119},[74,1273,754],{"class":145},[74,1275,491],{"class":119},[74,1277,199],{"class":115},[74,1279,765],{"class":80},[74,1281,1282],{"class":119},"({\n",[74,1284,1285,1288,1291],{"class":76,"line":132},[74,1286,1287],{"class":119},"  queryKey: [",[74,1289,1290],{"class":84},"\"todos\"",[74,1292,1293],{"class":119},"],\n",[74,1295,1296],{"class":76,"line":139},[74,1297,1298],{"class":119},"  queryFn: fetchTodos,\n",[74,1300,1301,1304,1307,1310],{"class":76,"line":161},[74,1302,1303],{"class":119},"  enabled: ",[74,1305,1306],{"class":115},"!!",[74,1308,1309],{"class":119},"userId, ",[74,1311,1312],{"class":792},"\u002F\u002F 조건부 실행\n",[74,1314,1315,1318,1321,1324,1327,1329,1332,1334],{"class":76,"line":166},[74,1316,1317],{"class":119},"  staleTime: ",[74,1319,1320],{"class":145},"1000",[74,1322,1323],{"class":115}," *",[74,1325,1326],{"class":145}," 60",[74,1328,1323],{"class":115},[74,1330,1331],{"class":145}," 5",[74,1333,341],{"class":119},[74,1335,1336],{"class":792},"\u002F\u002F 5분 간 fresh\n",[74,1338,1339,1342,1344,1346,1348,1350,1353,1355],{"class":76,"line":178},[74,1340,1341],{"class":119},"  cacheTime: ",[74,1343,1320],{"class":145},[74,1345,1323],{"class":115},[74,1347,1326],{"class":145},[74,1349,1323],{"class":115},[74,1351,1352],{"class":145}," 10",[74,1354,341],{"class":119},[74,1356,1357],{"class":792},"\u002F\u002F 10분 동안 메모리 유지\n",[74,1359,1360,1363,1365,1367],{"class":76,"line":187},[74,1361,1362],{"class":119},"  refetchOnWindowFocus: ",[74,1364,585],{"class":145},[74,1366,341],{"class":119},[74,1368,1369],{"class":792},"\u002F\u002F 창 포커스 시 refetch 안함\n",[74,1371,1372,1375,1378,1380],{"class":76,"line":205},[74,1373,1374],{"class":119},"  retry: ",[74,1376,1377],{"class":145},"2",[74,1379,341],{"class":119},[74,1381,1382],{"class":792},"\u002F\u002F 실패 시 2회까지 재시도\n",[74,1384,1385],{"class":76,"line":217},[74,1386,1387],{"class":119},"});\n",[1101,1389],{},[40,1391,1392],{},[250,1393,1394],{},[253,1395,1396],{},[1397,1398,1402],"a",{"href":1399,"rel":1400},"https:\u002F\u002Ftanstack.com\u002Fquery\u002Fv5\u002Fdocs\u002Fframework\u002Freact\u002Foverview",[1401],"nofollow","tanstack-query 공식문서",[1404,1405,1406],"style",{},"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 .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 .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .s4XuR, html code.shiki .s4XuR{--shiki-default:#E36209;--shiki-dark:#FFAB70}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .s9eBZ, html code.shiki .s9eBZ{--shiki-default:#22863A;--shiki-dark:#85E89D}",{"title":70,"searchDepth":132,"depth":132,"links":1408},[1409,1410,1415],{"id":59,"depth":132,"text":60},{"id":91,"depth":132,"text":1411,"children":1412},"사용방법 useQuery - 데이터 가져오기",[1413,1414],{"id":247,"depth":139,"text":248},{"id":680,"depth":139,"text":681},{"id":1105,"depth":132,"text":1106,"children":1416},[1417],{"id":1255,"depth":139,"text":1256},"TanStack Query가 웹 애플리케이션에서 데이터 가져오기, 캐싱, 상태 관리를 어떻게 개선하는지 알아본다.","md",{"date":1421,"field":1422,"tags":1423},"2025.04.15","frontend",[1424,1425],"react","tanstack-query","\u002Fko\u002Ftanstack-query-guide",{"title":5,"description":1418},{"loc":1426},"ko\u002Ftanstack-query-guide","rkMDw3o9v7EOD18nZ_PZ7xYWPDMRWwxDeit-_KvOwBk",[1432,1443,1452,1460,1468,1475,1485,1493,1500,1512,1520,1529,1535,1542,1549,1556,1562,1571,1581,1588,1594,1601,1608,1616,1623,1630,1639,1646,1653,1660,1663,1670,1678,1684],{"path":1433,"title":1434,"description":1435,"meta":1436},"\u002Fko\u002Fadsense-ads-txt-and-seo-indexing-bug","애드센스 ads.txt 경고를 받고 파헤치다가 찾은 진짜 색인 버그","구글 애드센스가 ads.txt 문제를 알려왔는데, 확인해보니 파일은 멀쩡했다. 대신 서치콘솔 색인 수가 적었던 진짜 원인을 Nuxt Content 슬러그 불일치 버그에서 찾은 과정을 정리한다.",{"date":1437,"field":1438,"tags":1439},"2026.09.17","blog",[1440,1441,1442],"seo","adsense","nuxt-content",{"path":1444,"title":1445,"description":1446,"meta":1447},"\u002Fko\u002Fcss-layouts","CSS Flexbox 완전 정복 가이드","Flexbox를 활용한 반응형 레이아웃 구현 방법과 실전 예제. 수직 정렬, 네비게이션 바, 카드 레이아웃까지 완벽 정리!",{"date":1448,"image":1449,"field":1422,"tags":1450},"2025.01.25","css.jpg",[1451],"css",{"path":1453,"title":1454,"description":1455,"meta":1456},"\u002Fko\u002Fcss-login-form","로그인","로그인 UI를 그려보자",{"date":1457,"field":1422,"tags":1458},"2025.03.29",[1459,1451],"html",{"path":1461,"title":1462,"description":1463,"meta":1464},"\u002Fko\u002Fcsv-parser-cleaning","복잡한 CSV 데이터를 안전하게 파싱하는 방법","JavaScript에서 큰따옴표, 줄바꿈, 쉼표 등 복잡한 CSV 데이터를 안전하게 객체로 변환하는 전체 과정 설명",{"date":1465,"field":1422,"tags":1466},"2025.06.19",[1467],"javascript",{"path":1469,"title":1470,"description":1471,"meta":1472},"\u002Fko\u002Fdebounce-guide","debounce와 throttle이란??","반복되는 함수 호출을 제어하는 기술인 디바운스(debounce)와 쓰로틀(throttle)을 알아보자.",{"date":1473,"field":1422,"tags":1474},"2025.03.26",[1467],{"path":1476,"title":1477,"description":1478,"meta":1479},"\u002Fko\u002Fdeclarative-vs-procedural-programming","선언적 프로그래밍 vs 절차형 프로그래밍","선언적 프로그래밍과 절차형 프로그래밍은 서로 대비되는 대표적인 패러다임이다. 두 패러다임의 차이를 알아보고, 각 패러다임에 해당하는 언어와 Vue\u002FReact의 특징을 살펴보자.",{"date":1480,"field":1481,"tags":1482},"2025.05.24","concepts",[1483,1484,1424],"paradigm","vue",{"path":1486,"title":1487,"description":1488,"meta":1489},"\u002Fko\u002Fdesign-guide","Design-Guide","A comprehensive guide on design principles and best practices for developers.",{"date":1490,"field":1422,"tags":1491},"2025.01.19",[1492],"design-system",{"path":1494,"title":1495,"description":1496,"meta":1497},"\u002Fko\u002Fdikw-pyramid","DIKW 피라미드 정리: 데이터가 지혜가 되기까지","Data, Information, Knowledge, Wisdom 4단계로 구성된 DIKW 피라미드 개념을 로그\u002F분석 데이터 같은 실제 개발 사례에 대입해서 정리한다.",{"date":1498,"field":1481,"tags":1499},"2026.09.18",[488],{"path":1501,"title":1502,"description":1503,"meta":1504},"\u002Fko\u002Fdisplaying-commits-with-github-actions","깃허브 액션으로 커밋 로그를 블로그에 띄우기: Nuxt와 Vercel 활용법","깃허브 액션을 통해 커밋 데이터를 자동으로 수집하고, Nuxt와 Vercel로 UI에 노출하는 방법을 소개합니다.",{"date":1505,"image":1506,"field":1507,"tags":1508},"2025.02.28","github-commits.jpg","infra",[1509,1510,1511],"github-actions","vercel","nuxt",{"path":1513,"title":1514,"description":1515,"meta":1516},"\u002Fko\u002Fdocker-auto-build-run","로컬에서 커밋 시 도커 빌드 후 컨테이너 시작하기","로컬에서 커밋 시 도커 빌드 후 컨테이너 시작하기.",{"date":1517,"field":1507,"tags":1518},"2025.03.10",[1519],"docker",{"path":1521,"title":1522,"description":1523,"meta":1524},"\u002Fko\u002Fhow-to-mount-storage","라즈베리파이4에 저장장치 마운트 시키기","라즈베리파이에 저장장치를 연결하고 파티션 생성부터 포맷, 마운트까지의 전체 과정을 정리한 기록입니다.",{"date":1525,"field":1507,"tags":1526},"2025.07.11",[1527,1528],"raspberry-pi","linux",{"path":1530,"title":1531,"description":1531,"meta":1532},"\u002Fko\u002Fhtml","HTML이란 무엇인가",{"date":1448,"image":1533,"field":1422,"tags":1534},"html.jpg",[1459],{"path":1536,"title":1537,"description":1538,"meta":1539},"\u002Fko\u002Fhtml2","미치광이 카드 컴포넌트","미치광이 카드 컴포넌트는 어떤 느낌일까",{"date":1540,"field":1422,"tags":1541},"2025.03.28",[1459,1451],{"path":1543,"title":1544,"description":1544,"meta":1545},"\u002Fko\u002Fhttps-guide","Let's Encrypt를 이용해서 HTTPS 적용하기",{"date":1546,"field":1507,"tags":1547},"2025.03.11",[1548],"https",{"path":1550,"title":1551,"description":1552,"meta":1553},"\u002Fko\u002Fjs-data-01","JavaScript 데이터01","JavaScript 데이터 다루는 문제를 풀어보자",{"date":1554,"field":1422,"tags":1555},"2025.03.08",[1467],{"path":1557,"title":1558,"description":1559,"meta":1560},"\u002Fko\u002Fjs-data-02","JavaScript 데이터02","복잡한 데이터 구조를 다루는 실전 문제를 해결해보자.",{"date":1554,"field":1422,"tags":1561},[1467],{"path":1563,"title":1564,"description":1565,"meta":1566},"\u002Fko\u002Fmarkdown-guid","마크다운 문법","마크다운 문법을 알아보자",{"date":1567,"image":1568,"field":1438,"tags":1569},"2025.03.02","markdown.webp",[1570],"markdown",{"path":1572,"title":1573,"description":1574,"meta":1575},"\u002Fko\u002Fminio-guide","MinIO 완벽 가이드: 설치부터 Node.js 연동까지","MinIO는 오픈소스 기반의 고성능 객체 스토리지 서버입니다. AWS S3와 호환되는 API를 제공하여 클라우드 네이티브 애플리케이션을 위한 완벽한 스토리지 솔루션으로 자리잡고 있습니다.",{"date":1576,"field":1577,"tags":1578},"2025.11.23","backend",[1579,1580],"minio","nodejs",{"path":1582,"title":1583,"description":1584,"meta":1585},"\u002Fko\u002Fnode-simple-server","Node.js 간단한 서버 만들기","Node.js로 간단한 HTTP 서버를 만드는 방법",{"date":1586,"field":1577,"tags":1587},"2025.01.30",[1580],{"path":1589,"title":1590,"description":1591,"meta":1592},"\u002Fko\u002Fnuxt-colormode","Nuxt3 다크모드 적용하기","Nuxt3에 다크모드 적용하여 관리하기",{"date":1457,"field":1422,"tags":1593},[1511],{"path":1595,"title":1596,"description":1597,"meta":1598},"\u002Fko\u002Fnuxt-content-vercel-empty-query-sqlite","배포만 하면 블로그 글이 하나도 안 보이던 버그: Nuxt Content와 Vercel의 \u002Ftmp 문제","로컬에서는 멀쩡한데 Vercel에 올리면 queryCollection()이 빈 배열만 반환하던 버그를 추적한 과정. 원인은 @nuxt\u002Fcontent가 Vercel의 읽기 전용 파일시스템을 지원하기 전 버전에 고정돼 있었던 것.",{"date":1599,"field":1438,"tags":1600},"2026.10.07",[1442,1510],{"path":1602,"title":1603,"description":1604,"meta":1605},"\u002Fko\u002Fnuxt-runtimeconfig-appconfig","Nuxt 설정 runtimeConfig vs app.config 완전 정복","Nuxt3에서 전역 설정을 어떻게 관리하고, 어떤 기준으로 나누어야 할까? 다크모드 예시부터 실무 기준 설정 전략까지 총정리",{"date":1606,"field":1422,"tags":1607},"2025.06.16",[1511],{"path":1609,"title":1610,"description":1611,"meta":1612},"\u002Fko\u002Fnuxt-useasyncdata-cache-error","useAsyncData 캐싱 문제와 Key 동적 설정으로 해결하기","이전 포스트의 데이터가 계속 출력되는 캐싱 관련 문제를 해결하는 방법",{"date":1613,"field":1422,"tags":1614,"image":1615},"2025.01.24",[1511],"cache.jpg",{"path":1617,"title":1618,"description":1619,"meta":1620},"\u002Fko\u002Fnuxt-vercel-sql-error","Nuxt 3에서 Vercel 배포 시 발생한 md 파일 로딩 문제 해결기","Nuxt 3 웹 어플리케이션에서 Vercel 배포 환경에서 발생한 md 파일 로딩 문제를 분석하고 해결한 방법에 대해 공유합니다.",{"date":1613,"image":1621,"field":1422,"tags":1622},"ssg.jpg",[1511,1442,1510],{"path":1624,"title":1625,"description":1626,"meta":1627},"\u002Fko\u002Fnuxt3-pinia-guide","nuxt3 Pinia 적용하기","Nuxt3 프로젝트에서 Pinia를 적용해보자 @pinia\u002Fnuxt",{"date":1457,"field":1422,"tags":1628},[1511,1629],"pinia",{"path":1631,"title":1632,"description":1633,"meta":1634},"\u002Fko\u002Fnuxt3-unit-test","Nuxt 프로젝트에 유닛 테스트 코드 추가하기","Nuxt 3 프로젝트에서 Vitest를 활용한 테스트 환경 설정과 유틸리티 함수 테스트 방법",{"date":1635,"image":1636,"field":1422,"tags":1637},"2025.03.07","unit-test.jpg",[1511,1638],"vitest",{"path":1640,"title":1641,"description":1642,"meta":1643},"\u002Fko\u002Fpm2-guide","프로세스 매니저 PM2","배포환경에서 유용하게 사용할 수 있는 프로세스 매니저를 알아보자.",{"date":1517,"field":1507,"tags":1644},[1645,1580],"pm2",{"path":1647,"title":1648,"description":1649,"meta":1650},"\u002Fko\u002Freact-createportal","React createPortal 완벽 가이드","React의 `createPortal`을 활용한 UI 구현법, 활용 사례, 장단점 및 코드 예제를 소개합니다.",{"date":1651,"field":1422,"tags":1652},"2025.01.27",[1424],{"path":1654,"title":1655,"description":1656,"meta":1657},"\u002Fko\u002Frouting","Routing","Nuxt file-system routing creates a route for every file in the pages\u002F directory.",{"date":1658,"field":1422,"tags":1659},"2025.01.22",[1511],{"path":1426,"title":5,"description":1418,"meta":1661},{"date":1421,"field":1422,"tags":1662},[1424,1425],{"path":1664,"title":1665,"description":1666,"meta":1667},"\u002Fko\u002Fuse-context","리엑트 상태관리 useContext()","React에서 `useContext`를 사용하면 컴포넌트 트리에 깊이 중첩된 컴포넌트에서도 prop drilling 없이 상태를 공유할 수 있습니다. 이 글에서는 `useContext`의 개념, 사용 방법, 장단점, 그리고 실전 예제를 함께 알아보겠습니다.",{"date":1668,"field":1422,"tags":1669},"2025.02.03",[1424],{"path":1671,"title":1672,"description":1673,"meta":1674},"\u002Fko\u002Fvite-plugin-style-inject","리엑티 컴포넌트를 패키지 빌드 시 CSS 같이 적용시키기","dist에 css에 파일이 생성되었으나, 적용 안 되는 이유를 알아보고 에러를 처리하자",{"date":1675,"field":1422,"tags":1676},"2025.04.06",[1677,1424],"vite",{"path":1679,"title":1680,"description":1681,"meta":1682},"\u002Fko\u002Fvue-component-guide","Vue의 \u003Ccomponent :is \u002F> 완벽 정리: 동적 렌더링의 모든 것","Vue에서 \u003Ccomponent :is \u002F>를 활용한 동적 컴포넌트 렌더링 방법과 VNode, 컴포넌트 객체의 차이를 실전 예제로 이해하기",{"date":1448,"field":1422,"tags":1683},[1484],{"path":1685,"title":1686,"description":1687,"meta":1688},"\u002Fko\u002Fvue-query-ref-value-trap-nuxt3","Vue Query에서 데이터가 안 보이는 이유? Nuxt 3와 Ref 구조의 함정","Nuxt 3 + vue-query를 사용할 때 API 데이터가 `v-if` 조건문에서 제대로 표시되지 않는 현상을 해결한 경험을 바탕으로, Ref 구조와 template 디렉티브에서의 차이를 자세히 설명합니다.",{"date":1689,"field":1422,"tags":1690},"2025.06.08",[1511,1484,1425],1791391656482]