Back to Repositories

Testing Arabic Locale Meridiem Formatting in iamkun/dayjs

This test suite validates the Arabic (Saudi Arabia) locale functionality in the Day.js library, focusing on meridiem (AM/PM) formatting. It ensures proper time-of-day indicators in Arabic script for different hours throughout the day.

Test Coverage Overview

The test suite comprehensively covers meridiem formatting for the Arabic (Saudi Arabia) locale implementation.

Tests AM/PM indicators at different times (3 AM, 11 AM, 4 PM, 8 PM)
Verifies correct Arabic characters ‘ص’ for AM and ‘م’ for PM
Ensures consistent locale-specific time formatting

Implementation Analysis

The testing approach utilizes Jest’s testing framework with MockDate for consistent time-based testing. The implementation follows a structured pattern of setting up the locale, creating dayjs instances with specific timestamps, and asserting the expected Arabic meridiem indicators.

Uses dayjs.locale() for locale configuration
Implements format(‘A’) for meridiem extraction
Employs beforeEach and afterEach hooks for test isolation

Technical Details

Testing Framework: Jest
Mocking Library: MockDate
Plugins: relativeTime
Test Setup: Global beforeEach/afterEach hooks
Locale Implementation: ar-sa specific formatting

Best Practices Demonstrated

The test suite exemplifies several testing best practices for date/time manipulation libraries.

Proper test isolation using MockDate
Consistent test setup and teardown
Clear test case organization
Comprehensive coverage of time periods
Explicit locale handling

iamkun/dayjs

test/locale/ar-sa.test.js

            
import MockDate from 'mockdate'
import dayjs from '../../src'
import relativeTime from '../../src/plugin/relativeTime'
import '../../src/locale/ru'
import locale from '../../src/locale/ar-sa'

dayjs.extend(relativeTime)

beforeEach(() => {
  MockDate.set(new Date())
})

afterEach(() => {
  MockDate.reset()
})

it('Meridiem', () => {
  dayjs.locale(locale)
  expect(dayjs('2020-01-01 03:00:00').locale('ar-sa').format('A')).toEqual('ص')
  expect(dayjs('2020-01-01 11:00:00').locale('ar-sa').format('A')).toEqual('ص')
  expect(dayjs('2020-01-01 16:00:00').locale('ar-sa').format('A')).toEqual('م')
  expect(dayjs('2020-01-01 20:00:00').locale('ar-sa').format('A')).toEqual('م')
})