Tillitsdone
down Scroll to discover

Testing React Query Components: A Guide

Learn how to effectively test React components that use React Query, including setup, mocking responses, and handling different states.

Master the best practices for reliable testing.
thumbnail

How to Test Components That Use React Query

A modern abstract sculpture made of intersecting geometric shapes and curved lines featuring bright orange deep blue and forest green colors. Camera angle: Low angle shot capturing the sculpture against a pure white background ultra-realistic cinematic 8K UHD high resolution sharp and detail

Testing React components that use React Query can be challenging at first, but with the right approach and tools, we can make it straightforward and reliable. Let’s dive into how we can effectively test these components while maintaining good testing practices.

Setting Up the Testing Environment

Before we start writing tests, we need to set up our testing environment properly. React Query provides a QueryClientProvider that needs to wrap our components during testing. We’ll create a custom wrapper to make this process easier.

import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
import { render } from '@testing-library/react'
export function renderWithClient(ui: React.ReactElement) {
const queryClient = new QueryClient({
defaultOptions: {
queries: {
retry: false,
},
},
})
return render(
<QueryClientProvider client={queryClient}>
{ui}
</QueryClientProvider>
)
}

An architectural structure with clean lines and geometric patterns featuring walnut brown and iron grey tones. The structure has layered elements creating depth and shadows. Camera angle: Wide angle perspective shot showing the full structure's symmetry high-quality ultra-realistic cinematic 8K UHD high resolution sharp and detail

Writing Your First Test

Let’s say we have a component that fetches and displays a list of todos. Here’s how we can test it:

describe('TodoList', () => {
it('displays todos when data is fetched successfully', async () => {
const { findByText } = renderWithClient(<TodoList />)
await waitFor(() => {
expect(screen.getByText('Todo 1')).toBeInTheDocument()
})
})
})

Mocking API Responses

One crucial aspect of testing React Query components is properly mocking the API responses. We can use MSW (Mock Service Worker) or Jest’s mocking capabilities:

const mockTodos = [
{ id: 1, title: 'Todo 1' },
{ id: 2, title: 'Todo 2' },
]
jest.mock('axios', () => ({
get: jest.fn(() => Promise.resolve({ data: mockTodos }))
}))

A flowing abstract design resembling ocean waves with October mist grey bright sand and black colors swirling together. The composition shows dynamic movement and natural patterns. Camera angle: Top-down aerial view capturing the intricate flow patterns high-quality ultra-realistic cinematic 8K UHD high resolution sharp and detail

Testing Different States

Remember to test your components in different states: loading, error, and success. React Query makes this easy with its built-in states:

it('shows loading state', () => {
const { getByText } = renderWithClient(<TodoList />)
expect(getByText('Loading...')).toBeInTheDocument()
})
it('shows error state', async () => {
// Mock failed API call
jest.spyOn(axios, 'get').mockRejectedValueOnce(new Error('Failed to fetch'))
const { findByText } = renderWithClient(<TodoList />)
await findByText('Error: Failed to fetch')
})

Best Practices

  1. Always clean up after each test by clearing the query cache
  2. Use waitFor or findBy queries for asynchronous operations
  3. Test loading, success, and error states
  4. Mock API responses consistently
  5. Use meaningful test descriptions
  6. Keep tests focused and isolated

A concrete modern architectural element with minimal grey tones and bright forest green accents featuring clean geometric shapes and strong lines. The structure shows interesting play of light and shadow. Camera angle: Dutch angle (tilted) perspective highlighting the architectural details high-quality ultra-realistic cinematic 8K UHD high resolution sharp and detail

icons/logo-tid.svg Latest Blogs
Discover our top articles, selected to support the growth of your business.
https://imgproxy-landing-page.tillitsdone.com/sig/rs:fit:1200:630/plain/https%3A%2F%2Fcms-r2.tillitsdone.com%2Fwp-content-prod%2Fuploads%2F2025%2F10%2FTill-its-done_SEO_R38_Sep_1440x697.jpg@webp TypeScript Interface คืออะไร? อธิบายพร้อมวิธีใช้และข้อแตกต่างจาก Type เรียนรู้วิธีใช้ TypeScript Interface เพื่อสร้างโครงสร้างข้อมูลที่ปลอดภัยและเข้าใจง่าย พร้อมเปรียบเทียบข้อดีข้อแตกต่างกับ Type ที่คุณต้องรู้ ถูกรวมเอาไว้ในบทความนี้แล้ว https://imgproxy-landing-page.tillitsdone.com/sig/rs:fit:1200:630/plain/https%3A%2F%2Fcms-r2.tillitsdone.com%2Fwp-content-prod%2Fuploads%2F2025%2F10%2FTill-its-done_SEO_R37_Sep_1440x697.jpg@webp วิธีใช้งาน Material-UI (MUI) กับ React โปรเจกต์ พร้อมตัวอย่างโค้ด เรียนรู้วิธีใช้งาน Material-UI กับ React อย่างง่าย พร้อมตัวอย่างโค้ดที่จะเสริมสร้างความเข้าใจในการใช้งาน Material-UI กับ React ให้มากยิ่งขึ้นไปกว่าเก่า https://imgproxy-landing-page.tillitsdone.com/sig/rs:fit:1200:630/plain/https%3A%2F%2Fcms-r2.tillitsdone.com%2Fwp-content-prod%2Fuploads%2F2025%2F09%2FTill-its-done_SEO_R36_Sep_1440x697.jpg@webp Material-UI (MUI) คืออะไร อยากสร้าง UI สวยงามและเป็นมืออาชีพในเวลาอันรวดเร็วใช่ไหม มาทำความรู้จักกับ Material-UI (MUI) ที่ช่วยให้คุณพัฒนาแอปพลิเคชันบน React ได้ง่ายและดูดีในทุกอุปกรณ์ https://imgproxy-landing-page.tillitsdone.com/sig/rs:fit:1200:630/plain/https%3A%2F%2Fcms-r2.tillitsdone.com%2Fwp-content-prod%2Fuploads%2F2025%2F09%2FTill-its-done_SEO_R35_Sep_1440x697.jpg@webp มือใหม่อยากเริ่มเขียนแอป ต้องใช้โปรแกรมและภาษาอะไรบ้าง? อยากเป็นนักพัฒนาแอปแต่ไม่รู้จะเริ่มยังไง พบกับแนวทางการเลือกเครื่องมือและภาษาเบื้องต้นพร้อมคำแนะ เพื่อก้าวสู่เส้นทางการเขียนแอปอย่างมั่นใจในบทความนี้ https://imgproxy-landing-page.tillitsdone.com/sig/rs:fit:1200:630/plain/https%3A%2F%2Fcms-r2.tillitsdone.com%2Fwp-content-prod%2Fuploads%2F2025%2F09%2FTill-its-done_SEO_R27_Sep_1440x697.jpg@webp เปรียบเทียบ 3 วิธีติดตั้ง install node js บน Ubuntu: NVM vs NodeSource vs Official Repo แบบไหนดีที่สุด? เรียนรู้วิธีติดตั้ง Node.js บน Ubuntu ด้วย NVM, NodeSource หรือ Official Repo เลือกวิธีที่เหมาะกับความต้องการของคุณ พร้อมเปรียบเทียบ เพื่อการพัฒนาที่มีประสิทธิภาพ! https://imgproxy-landing-page.tillitsdone.com/sig/rs:fit:1200:630/plain/https%3A%2F%2Fcms-r2.tillitsdone.com%2Fwp-content-prod%2Fuploads%2F2025%2F09%2FTill-its-done_SEO_R26_Sep_1440x697.jpg@webp Next js image การ Optimization รูปภาพแบบ Native ที่มีประสิทธิภาพสูง เรียนรู้วิธีใช้ Next.js Image เพื่อ Optimization การแสดงภาพบนเว็บไซต์ ด้วยเทคนิคบีบอัด ปรับขนาด Lazy Load และรองรับ Responsive ช่วยให้เว็บคุณโหลดเร็วขึ้นแน่นอน!
icons/logo-tid.svg

Talk with CEO

Ready to bring your web/app to life or boost your team with expert Thai developers?
Contact us today to discuss your needs, and let’s create tailored solutions to achieve your goals. We’re here to help at every step!
🖐️ Contact us
down Explore our best articles, cover a wide variety of technologies
Our knowledge base
196 Articles
Explore right
icons/logo-react.svg ReactJs
Popular JavaScript library for building user interfaces with a component-based architecture.
160 Articles
Explore right
icons/flutter.svg Flutter
UI toolkit for building natively compiled applications for mobile, web, and desktop from a single codebase.
144 Articles
Explore right
icons/logo-nodejs.svg Nodejs
JavaScript runtime for building scalable, high-performance server-side applications.
58 Articles
Explore right
icons/next-js.svg Nextjs
React framework enabling server-side rendering and static site generation for optimized performance.
38 Articles
Explore right
icons/tailwind.svg TailwindCSS
Utility-first CSS framework for rapid UI development.
36 Articles
Explore right
icons/code-outline.svg Typescript
Superset of JavaScript adding static types for improved code quality and maintainability.
126 Articles
Explore right
icons/code-outline.svg Golang
Programming language known for its simplicity, concurrency model, and performance.
67 Articles
Explore right
icons/code-outline.svg AstroJs
Astro is an all-in-one web framework. It includes everything you need to create a website, built-in.
38 Articles
Explore right
icons/code-outline.svg Jest
Versatile testing framework for JavaScript applications supporting various test types.
13 Articles
Explore right
icons/code-outline.svg Website development th
10 Articles
Explore right
icons/code-outline.svg Mobile application th
5 Articles
Explore right
icons/code-outline.svg Reactjs th
3 Articles
Explore right
icons/code-outline.svg Flutter th
3 Articles
Explore right
icons/code-outline.svg Nextjs th
1 Articles
Explore right
icons/code-outline.svg Software house th
1 Articles
Explore right
icons/code-outline.svg Nodejs th
1 Articles
Explore right
icons/code-outline.svg Typescript th
337 Articles
Explore right
icons/css-4.svg CSS
CSS3 is the latest version of Cascading Style Sheets, offering advanced styling features like animations, transitions, shadows, gradients, and responsive design.
Let's keep in Touch
Thank you for your interest in Tillitsdone! Whether you have a question about our services, want to discuss a potential project, or simply want to say hello, we're here and ready to assist you.
We'll be right here with you every step of the way.
Contact Information
rick@tillitsdone.com+66824564755
Find All the Ways to Get in Touch with Tillitsdone - We're Just a Click, Call, or Message Away. We'll Be Right Here, Ready to Respond and Start a Conversation About Your Needs.
Address
9 Phahonyothin Rd, Khlong Nueng, Khlong Luang District, Pathum Thani, Bangkok Thailand
Visit Tillitsdone at Our Physical Location - We'd Love to Welcome You to Our Creative Space. We'll Be Right Here, Ready to Show You Around and Discuss Your Ideas in Person.
Social media
FacebookInstagramLinkedIn
Connect with Tillitsdone on Various Social Platforms - Stay Updated and Engage with Our Latest Projects and Insights. We'll Be Right Here, Sharing Our Journey and Ready to Interact with You.
We anticipate your communication and look forward to discussing how we can contribute to your business's success.
We'll be here, prepared to commence this promising collaboration.
Frequently Asked Questions
Explore frequently asked questions about our products and services.
Whether you're curious about features, warranties, or shopping policies, we provide comprehensive answers to assist you.