Ramda JS NPM（開發者的使用方法）

不可變性

不可變性是 Ramda 的關鍵原則。 Ramda 中的函數不會修改輸入數據，而是返回新的數據結構。 這種方法降低了副作用的風險，使代碼更可預測且更易於調試。

更純的函數式風格

為 JavaScript 程式員設計的 Ramda 庫鼓勵使用純函數，這些函數在相同的輸入下始終產生相同的輸出，且沒有副作用。 純函數提高了代碼的可靠性並使其更容易測試。

創建函數式管道

Ramda 提供函數組合工具，允許開發人員通過組合簡單函數來構建複雜的操作。 這種可組合性使得創建功能性、更易於閱讀和維護的代碼變得容易。

柯里化

所有 Ramda 函數都自動柯里化。 柯里化涉及將接受多個參數的函數分解為一系列函數，每個函數只接收一個參數。 此特性啟用部分應用，其中函數的一些參數可以被固定，創建一個接受其餘參數的新函數。

不可變性

下面的例子演示了 Ramda 的不可變性特徵。 它從不改變用戶數據； 而是添加到原始數據結構中：

const originalArray = [1, 2, 3, 4];
const newArray = R.append(5, originalArray);

// Log the original array and the new augmented array
console.log(originalArray); // [1, 2, 3, 4]
console.log(newArray);      // [1, 2, 3, 4, 5]

const originalArray = [1, 2, 3, 4];
const newArray = R.append(5, originalArray);

// Log the original array and the new augmented array
console.log(originalArray); // [1, 2, 3, 4]
console.log(newArray);      // [1, 2, 3, 4, 5]

純函數

考慮一個將兩個數字相加的函數：

const add = R.add;
console.log(add(2, 3)); // 5

const add = R.add;
console.log(add(2, 3)); // 5

由於 R.add 是純函數，對於相同的輸入，它將始終返回相同的結果。

功能組合

功能組合允許從簡單的函數構建複雜的操作。 Ramda 提供 R.compose 和 R.pipe 來實現這一目的：

const multiplyBy2 = R.multiply(2);
const subtract1 = R.subtract(R.__, 1);
const multiplyAndSubtract = R.compose(subtract1, multiplyBy2);

// First multiply by 2, then subtract 1
console.log(multiplyAndSubtract(5)); // 9

const multiplyBy2 = R.multiply(2);
const subtract1 = R.subtract(R.__, 1);
const multiplyAndSubtract = R.compose(subtract1, multiplyBy2);

// First multiply by 2, then subtract 1
console.log(multiplyAndSubtract(5)); // 9

柯里化

柯里化將函數轉變為可以用少於預期的參數調用的函數。 Ramda 默認地對其所有函數進行柯里化：

// A function to add three numbers
const addThreeNumbers = (a, b, c) => a + b + c;

// Currying the function using Ramda's R.curry
const curriedAddThreeNumbers = R.curry(addThreeNumbers);

// Create a new function by partially applying two arguments
const add5And10 = curriedAddThreeNumbers(5)(10);

// Call the new function with the remaining argument
console.log(add5And10(2)); // 17

// A function to add three numbers
const addThreeNumbers = (a, b, c) => a + b + c;

// Currying the function using Ramda's R.curry
const curriedAddThreeNumbers = R.curry(addThreeNumbers);

// Create a new function by partially applying two arguments
const add5And10 = curriedAddThreeNumbers(5)(10);

// Call the new function with the remaining argument
console.log(add5And10(2)); // 17

鏡頭

Ramda 的鏡頭是強大的功能用於不可變數據操作。 它們提供了一種專注於基本數據結構中特定部分的方法，允許安全的讀取和更新。

const person = { name: 'John', address: { city: 'New York', zip: 10001 } };

// Create a lens that focuses on the 'address' property
const addressLens = R.lensProp('address');

// Create a lens that focuses on the 'city' within the 'address' object
const cityLens = R.lensPath(['address', 'city']);

// Update city to 'Los Angeles' immutably
const updatedPerson = R.set(cityLens, 'Los Angeles', person);

// Retrieve the updated city from the new person object
console.log(R.view(cityLens, updatedPerson)); // Los Angeles

// Verify no mutation occurred on the original object
console.log(person.address.city); // New York

const person = { name: 'John', address: { city: 'New York', zip: 10001 } };

// Create a lens that focuses on the 'address' property
const addressLens = R.lensProp('address');

// Create a lens that focuses on the 'city' within the 'address' object
const cityLens = R.lensPath(['address', 'city']);

// Update city to 'Los Angeles' immutably
const updatedPerson = R.set(cityLens, 'Los Angeles', person);

// Retrieve the updated city from the new person object
console.log(R.view(cityLens, updatedPerson)); // Los Angeles

// Verify no mutation occurred on the original object
console.log(person.address.city); // New York

轉換器

轉換器允許通過將篩選、映射和歸約的步驟結合到單次數據傳遞中來進行高效數據轉換管道。

const numbers = [1, 2, 3, 4, 5];

// Define functions to identify even numbers and double any number
const isEven = x => x % 2 === 0;
const double = x => x * 2;

// Create a transducer combining filtering and mapping operations
const transducer = R.compose(R.filter(isEven), R.map(double));

// Apply the transducer to transform the list
const result = R.transduce(transducer, R.flip(R.append), [], numbers);

console.log(result); // [4, 8]

const numbers = [1, 2, 3, 4, 5];

// Define functions to identify even numbers and double any number
const isEven = x => x % 2 === 0;
const double = x => x * 2;

// Create a transducer combining filtering and mapping operations
const transducer = R.compose(R.filter(isEven), R.map(double));

// Apply the transducer to transform the list
const result = R.transduce(transducer, R.flip(R.append), [], numbers);

console.log(result); // [4, 8]

點免費樣式

Ramda 鼓勵使用點免費函數編程風格，其中函數是在沒有明確提及其參數的情況下定義的。 這導致代碼更整齊且更簡潔。

// Calculate the sum of elements in a list
const sum = R.reduce(R.add, 0);

// Calculate the average value using sum and length
const average = R.converge(R.divide, [sum, R.length]);

console.log(average([1, 2, 3, 4, 5])); // 3

// Calculate the sum of elements in a list
const sum = R.reduce(R.add, 0);

// Calculate the average value using sum and length
const average = R.converge(R.divide, [sum, R.length]);

console.log(average([1, 2, 3, 4, 5])); // 3

什麼是 IronPDF？

IronPDF for Node.js, developed by Iron Software 開發，是一個強大的庫，能夠讓開發人員直接在 Node.js 環境中創建、操作和渲染 PDF 文檔。 它提供了一整套功能，能夠從各種來源（例如 URL、HTML 文件和 HTML 字串）生成 PDF，使其成為網頁應用程序的高度通用工具。 該庫簡化了複雜的 PDF 操作，允許使用最少的代碼進行直接的轉換和渲染。

使用 IronPDF，開發人員可以輕鬆將 PDF 生成集成到他們的工作流程中，從其中強大的功能和易用性中受益，這對於創建動態報告、發票和現代 Web 應用中的其他文檔功能特別有用。

安裝

首先，使用 npm 安裝 IronPDF for Node.js 套件：

 npm i @ironsoftware/ironpdf

基本用法

要結合使用 IronPDF 與 Ramda，需匯入所需模塊：

import { PdfDocument } from "@ironsoftware/ironpdf";
import * as R from "ramda";

import { PdfDocument } from "@ironsoftware/ironpdf";
import * as R from "ramda";