refactor(location): deprecate streetName (#2071)

Author: Shinigami92

docs/guide/upgrading.md

@@ -182,7 +182,7 @@ The `faker.address.*` methods will continue to work as an alias in v8 and v9, bu
 | `faker.address.stateAbbr`           | `faker.location.stateAbbr`           |
 | `faker.address.street`              | `faker.location.street`              |
 | `faker.address.streetAddress`       | `faker.location.streetAddress`       |
-| `faker.address.streetName`          | `faker.location.streetName`          |
+| `faker.address.streetName`          | `faker.location.street`              |
 | `faker.address.timeZone`            | `faker.location.timeZone`            |
 | `faker.address.zipCode`             | `faker.location.zipCode`             |
 | `faker.address.zipCodeByState`      | `faker.location.zipCodeByState`      |

src/modules/location/index.ts

@@ -199,12 +199,22 @@ export class LocationModule {
   /**
    * Returns a random localized street name.
    *
+   * @see faker.location.street()
+   *
    * @example
    * fakerDE.location.streetName() // 'Cavill Avenue'
    *
    * @since 8.0.0
+   *
+   * @deprecated Use `faker.location.street()` instead.
    */
   streetName(): string {
+    deprecated({
+      deprecated: 'faker.location.streetName',
+      proposed: 'faker.location.street',
+      since: '8.0',
+      until: '9.0',
+    });
     return this.faker.helpers.arrayElement(
       this.faker.definitions.location.street_name
     );