refactor(internet): deprecated redundant avatar method (#2601)

1 files changed, 13 insertions, 3 deletions

diff --git a/src/modules/internet/index.ts b/src/modules/internet/index.ts
index 395266fb..08ed60b6 100644
--- a/src/modules/internet/index.ts
+++ b/src/modules/internet/index.ts
@@ -41,16 +41,26 @@ export class InternetModule extends ModuleBase {
   /**
    * Returns a random avatar url.
    *
+   * @see faker.image.avatarLegacy(): For the replacement method.
+   * @see faker.image.avatar(): For the replacement method with a wider variety of avatars.
+   *
    * @example
    * faker.internet.avatar()
    * // 'https://cloudflare-ipfs.com/ipfs/Qmd3W5DuhgHirLHGVixi6V76LhCkZUz6pnFt5AJBiyvHye/avatar/315.jpg'
    *
    * @since 2.0.1
+   *
+   * @deprecated Use `faker.image.avatar()` instead.
    */
   avatar(): string {
-    return `https://cloudflare-ipfs.com/ipfs/Qmd3W5DuhgHirLHGVixi6V76LhCkZUz6pnFt5AJBiyvHye/avatar/${this.faker.number.int(
-      1249
-    )}.jpg`;
+    deprecated({
+      deprecated: 'faker.internet.avatar()',
+      proposed: 'faker.image.avatarLegacy() or faker.image.avatar()',
+      since: '8.4',
+      until: '9.0',
+    });
+    // TODO @ST-DDT 2024-01-14: Remove or replace with `faker.image.avatar()` in v9
+    return this.faker.image.avatarLegacy();
   }
 
   /**