test: ensure jsdoc deprecated tags have a message

Author: ST-DDT

src/modules/phone/index.ts

@@ -27,7 +27,7 @@ export class Phone {
    * faker.phone.phoneNumber('501-###-###') // '501-039-841'
    * faker.phone.phoneNumber('+48 91 ### ## ##') // '+48 91 463 61 70'
    *
-   * @deprecated
+   * @deprecated Use faker.phone.number() instead.
    */
   phoneNumber(format?: string): string {
     deprecated({

test/scripts/apidoc/examplesAndDeprecations.spec.ts

@@ -6,6 +6,7 @@ import type { SpyInstance } from 'vitest';
 import { afterAll, beforeEach, describe, expect, it, vi } from 'vitest';
 import {
   extractRawExamples,
+  extractTagContent,
   isDeprecated,
 } from '../../../scripts/apidoc/utils';
 import { faker } from '../../../src';
@@ -101,6 +102,10 @@ describe('examples and deprecations', () => {
       const deprecatedFlag = isDeprecated(signature);
       if (deprecatedFlag) {
         expect(consoleSpies[1]).toHaveBeenCalled();
+        expect(
+          extractTagContent('@deprecated', signature).join(''),
+          '@deprecated tag without message'
+        ).not.toBe('');
       } else {
         for (const spy of consoleSpies) {
           expect(spy).not.toHaveBeenCalled();