作品：https://code-art.pictures/

想像圖書館：

• 像 Ramda 一樣，提供了許多有用的可迭代操作函數(shù)
• 讀起來很熟悉，就像標(biāo)準(zhǔn)陣列迭代方法一樣
• 不會嘗試取代 JavaScript 內(nèi)建函數(shù)，例如 Array、Set 或迭代協(xié)議
• 像 Java Streams 一樣，包括Optional以明確區(qū)分「無值」和「未定義為值」
• 捆綁包尺寸小巧

我找不到一個能夠滿足所有這些需求的函式庫，所以我建立了我的小函式庫 - Fluent-streams。

談話很便宜。顯示程式碼

文中最常見的 3 個單字

const words = ['Lorem', 'ipsum', /* ... */]
stream(words)
  .groupBy(word => word.toLowerCase())
  .map(([word, list]) => [word, list.length])
  .sortBy(([, length])  => -length)
  .take(3)
  .toArray()

// => ['ut', 3], ['in', 3], ['dolor', 2]

互質(zhì)整數(shù)

// Endless stream of 2..999 integers
const randomInts = continually(() => 
  2 + Math.floor(Math.random() * 998)
)

randomInts
  .zip(randomInts)
  .filter(([a, b]) => gcd(a, b) === 1)
  .distinctBy(pair => stream(pair).sortBy(i => i).join())
  .take(10)

// => [804, 835], [589, 642], [96, 145], ...

• 流可以是無限的，如圖所示，但您可以使用 take(n) 方法將它們限制為前 n 個項目
• 流可以多次重複使用，甚至可以並行重複使用。這是因為流是無狀態(tài)的並且僅儲存對輸入的引用。僅當(dāng)流產(chǎn)生迭代器時才會建立狀態(tài)。

生成一副牌

const deck = streamOf('?', '?', '?', '?')
  .flatMap(suit =>
    streamOf<string | number>(
      'A',
      ...range(2, 11),
      'J',
      'Q',
      'K'
    ).map(rank => `${rank}${suit}`)
  )

// => 'A?', '2?', '3?', ...

並玩德州撲克！

  const playersNum = 2
  const [flop, turn, river, ...hands] = deck
    .takeRandom(3 + 1 + 1 + playersNum * 2)
    .zipWithIndex()
    .splitWhen((_, [, j]) =>
      j === 3            // flop
      || j === 4         // turn
      || j >= 5          // river
         && j % 2 === 1  // ...players' hands
    )
    .map(chunk =>
      // Unzip index
      chunk.map(([card]) => card)
    )

// flop = ['3?', '9?', 'J?']
// turn = ['4?']
// river = ['7?']
// hands = ['J?', '4?'], ['10?', '8?']

第一個玩家在翻牌圈有一對 J，而第二個玩家在河牌圈得到順子。誰會獲勝？

這一定很便宜

以上所有內(nèi)容都可以只使用本機(jī)資料結(jié)構(gòu)來實現(xiàn)。然而，使用 Fluent Streams 編寫的程式碼讀起來更好。雖然使程式碼更具可讀性是一個完全有效的目標(biāo)，但在認(rèn)知負(fù)載、套件大小和效能方面實現(xiàn)它的成本應(yīng)該很低。

Fluent Streams 正是如此！原因如下：

• 沒有學(xué)習(xí)曲線：API 感覺很熟悉，類似標(biāo)準(zhǔn)陣列方法。添加很容易，刪除也很容易。
• 沒有重新發(fā)明：該程式庫不會建立新的資料結(jié)構(gòu)或協(xié)定 - 它是建構(gòu)在 JavaScript 已經(jīng)強(qiáng)大的功能之上。
• 最小的捆綁影響：壓縮後大小僅 8.5 kB，非常輕量。如果您的專案已經(jīng)包含 React 及其附屬庫（其重達(dá)數(shù)百千位元組），則這種添加幾乎不會被注意到。
• 延遲處理：庫延遲處理項目，透過避免不必要的中間資料複製，可以減少記憶體使用並提高長管道的效率。

注意事項

庫已未轉(zhuǎn)譯到 ES5。這項決定是由於希望保持較小的套件大小而做出的，這是透過利用 ES6 功能來實現(xiàn)的，這些功能支援使用非常簡潔的程式碼進(jìn)行迭代——最值得注意的是生成器。但是，僅利用廣泛支援的語言功能。

如果您仍在編譯到 ES5，您可以透過自己編譯並新增 polyfill 來使用該函式庫。但請注意，這會增加捆綁包的大小，因此不建議這樣做。相反，這可能是重新審視建立配置並擁抱現(xiàn)代 JavaScript 功能的最佳時機(jī)。

祝你編碼愉快！

以上是Fluent Streams：用於豐富可迭代操作的函式庫的詳細(xì)內(nèi)容。更多資訊請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！