feat: expose textArrayElement as standalone method

[ST-DDT]

Clear and concise description of the problem

Currently all word methods and the lorem.word method use the same implementation. It is likely that other developers might have a similar usecase for their word lists.

Suggested solution

Extract and expose the textArrayElement method from the helpers module.

textArrayElement(
    textList: string[],
    options:
      | number
      | {
          length?: number | { min: number; max: number };
          strategy?: 'fail' | 'closest' | 'shortest' | 'longest' | 'any-length';
        } = {}
  ): string

Alternative

No response

Additional context

Source: #1407 (comment)

[ST-DDT]

Workaround:

textList.filter(someCondition)

If you are interested in this features please upvote this issue.

[github-actions]

Thank you for your feature proposal.

We marked it as "waiting for user interest" for now to gather some feedback from our community:

• If you would like to see this feature be implemented, please react to the description with an up-vote (:+1:).
• If you have a suggestion or want to point out some special cases that need to be considered, please leave a comment, so we are aware about them.

We would also like to hear about other community members' use cases for the feature to give us a better understanding of their potential implicit or explicit requirements.

We will start the implementation based on:

• the number of votes (:+1:) and comments
• the relevance for the ecosystem
• availability of alternatives and workarounds
• and the complexity of the requested feature

We do this because:

• There are plenty of languages/countries out there and we would like to ensure that every method can cover all or almost all of them.
• Every feature we add to faker has "costs" associated to it:
  • initial costs: design, implementation, reviews, documentation
  • running costs: awareness of the feature itself, more complex module structure, increased bundle size, more work during refactors

---

View more issues which are waiting for user interest