Skip to content

The open alternative to Salesforce, designed for AI.

3.2 KB
Raw Blame
import { formatEmailAddress } from '../formatEmailAddress';
import { parseEmailAddressList } from '../parseEmailAddressList';

describe('formatEmailAddress', () => {
  it('should return the bare address when there is no name', () => {
    expect(formatEmailAddress({ address: '[email protected]' })).toBe(
      '[email protected]',
    );
    expect(formatEmailAddress({ address: '[email protected]', name: '' })).toBe(
      '[email protected]',
    );
  });

  it('should append the name unquoted when it contains no special characters', () => {
    expect(
      formatEmailAddress({ address: '[email protected]', name: 'Alice Doe' }),
    ).toBe('Alice Doe <[email protected]>');
  });

  it('should quote names containing special characters', () => {
    expect(
      formatEmailAddress({ address: '[email protected]', name: 'Doe, John' }),
    ).toBe('"Doe, John" <[email protected]>');
  });

  it('should escape double quotes inside quoted names', () => {
    expect(
      formatEmailAddress({ address: '[email protected]', name: 'A "B" C' }),
    ).toBe('"A \\"B\\" C" <[email protected]>');
  });

  it('should quote and escape backslashes so they cannot neutralize quote escaping', () => {
    expect(
      formatEmailAddress({ address: '[email protected]', name: 'A \\ B' }),
    ).toBe('"A \\\\ B" <[email protected]>');
    expect(
      formatEmailAddress({ address: '[email protected]', name: 'x\\"y' }),
    ).toBe('"x\\\\\\"y" <[email protected]>');
  });

  it('should keep a backslash-and-quote name inside one recipient when reparsed', () => {
    const formatted = formatEmailAddress({
      address: '[email protected]',
      name: 'x\\"y',
    });
    const reparsed = parseEmailAddressList(`${formatted}, [email protected]`);

    expect(reparsed).toHaveLength(2);
    expect(reparsed[0]?.address).toBe('[email protected]');
    // addressparser collapses the escaped backslash, so only containment is asserted.
    expect(reparsed[0]?.name).toBe('x"y');
    expect(reparsed[1]).toEqual({ address: '[email protected]', name: '' });
  });

  it('should quote names containing group or comment syntax so they round-trip', () => {
    const colonFormatted = formatEmailAddress({
      address: '[email protected]',
      name: 'Re: update',
    });

    expect(colonFormatted).toBe('"Re: update" <[email protected]>');
    expect(parseEmailAddressList(colonFormatted)).toEqual([
      { address: '[email protected]', name: 'Re: update' },
    ]);

    const parenthesesFormatted = formatEmailAddress({
      address: '[email protected]',
      name: 'Bob (Sales)',
    });

    expect(parenthesesFormatted).toBe('"Bob (Sales)" <[email protected]>');
    expect(parseEmailAddressList(parenthesesFormatted)).toEqual([
      { address: '[email protected]', name: 'Bob (Sales)' },
    ]);
  });

  it('should not quote RFC 2047 encoded words', () => {
    expect(
      formatEmailAddress({
        address: '[email protected]',
        name: '=?UTF-8?B?VGVzdCBVc2Vy?=',
      }),
    ).toBe('=?UTF-8?B?VGVzdCBVc2Vy?= <[email protected]>');
  });

  it('should round-trip through parseEmailAddressList', () => {
    const formatted = formatEmailAddress({
      address: '[email protected]',
      name: 'Doe, John',
    });

    expect(parseEmailAddressList(formatted)).toEqual([
      { address: '[email protected]', name: 'Doe, John' },
    ]);
  });
});