test: create some hooks and utils test script, modified clipboard test script (#27928)

web/hooks/use-breakpoints.spec.ts

@@ -1,10 +1,27 @@
+/**
+ * Test suite for useBreakpoints hook
+ *
+ * This hook provides responsive breakpoint detection based on window width.
+ * It listens to window resize events and returns the current media type.
+ *
+ * Breakpoint definitions:
+ * - mobile: width <= 640px
+ * - tablet: 640px < width <= 768px
+ * - pc: width > 768px
+ *
+ * The hook automatically updates when the window is resized and cleans up
+ * event listeners on unmount to prevent memory leaks.
+ */
 import { act, renderHook } from '@testing-library/react'
 import useBreakpoints, { MediaType } from './use-breakpoints'
 
 describe('useBreakpoints', () => {
   const originalInnerWidth = window.innerWidth
 
-  // Mock the window resize event
+  /**
+   * Helper function to simulate window resize events
+   * Updates window.innerWidth and dispatches a resize event
+   */
   const fireResize = (width: number) => {
     window.innerWidth = width
     act(() => {
@@ -12,11 +29,18 @@ describe('useBreakpoints', () => {
     })
   }
 
-  // Restore the original innerWidth after tests
+  /**
+   * Restore the original innerWidth after all tests
+   * Ensures tests don't affect each other or the test environment
+   */
   afterAll(() => {
     window.innerWidth = originalInnerWidth
   })
 
+  /**
+   * Test mobile breakpoint detection
+   * Mobile devices have width <= 640px
+   */
   it('should return mobile for width <= 640px', () => {
     // Mock window.innerWidth for mobile
     Object.defineProperty(window, 'innerWidth', {
@@ -29,6 +53,10 @@ describe('useBreakpoints', () => {
     expect(result.current).toBe(MediaType.mobile)
   })
 
+  /**
+   * Test tablet breakpoint detection
+   * Tablet devices have width between 640px and 768px
+   */
   it('should return tablet for width > 640px and <= 768px', () => {
     // Mock window.innerWidth for tablet
     Object.defineProperty(window, 'innerWidth', {
@@ -41,6 +69,10 @@ describe('useBreakpoints', () => {
     expect(result.current).toBe(MediaType.tablet)
   })
 
+  /**
+   * Test desktop/PC breakpoint detection
+   * Desktop devices have width > 768px
+   */
   it('should return pc for width > 768px', () => {
     // Mock window.innerWidth for pc
     Object.defineProperty(window, 'innerWidth', {
@@ -53,6 +85,10 @@ describe('useBreakpoints', () => {
     expect(result.current).toBe(MediaType.pc)
   })
 
+  /**
+   * Test dynamic breakpoint updates on window resize
+   * The hook should react to window resize events and update the media type
+   */
   it('should update media type when window resizes', () => {
     // Start with desktop
     Object.defineProperty(window, 'innerWidth', {
@@ -73,6 +109,10 @@ describe('useBreakpoints', () => {
     expect(result.current).toBe(MediaType.mobile)
   })
 
+  /**
+   * Test proper cleanup of event listeners
+   * Ensures no memory leaks by removing resize listeners on unmount
+   */
   it('should clean up event listeners on unmount', () => {
     // Spy on addEventListener and removeEventListener
     const addEventListenerSpy = jest.spyOn(window, 'addEventListener')