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

不變性

不變性是Ramda的一個關鍵原則。 Ramda 中的函數不會修改輸入數據，而是傳回新的資料結構。 這種方法降低了副作用的風險，使程式碼更可預測，也更容易調試。

純粹的功能主義風格

Ramda 函式庫鼓勵 JavaScript 程式設計師使用純函數，純函數是指在給定相同輸入的情況下產生相同輸出且沒有副作用的函數。 純函數可以提高程式碼的可靠性，並使測試更加容易。

創建功能性管道

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 的 Lenses 是一個強大的功能，可用於對不可變資料進行操作。 它們提供了一種專注於基本資料結構特定部分的方法，從而可以安全地讀取和更新資料。

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

Ramda JS NPM（開發者使用指南）：圖 2

感應器

轉換器透過將過濾、映射和縮減步驟合併到對資料的一次處理中，從而實現高效的資料轉換管道。

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由Iron Software開發，是一個功能強大的函式庫，它使開發人員能夠直接在 Node.js 環境中建立、操作和渲染 PDF 文件。 它提供了一套全面的功能，可以從各種來源（例如 URL、HTML 文件和 HTML 字串）生成 PDF，使其在基於 Web 的應用程式中用途非常廣泛。 該程式庫簡化了複雜的 PDF 操作，只需編寫最少的程式碼即可輕鬆實現轉換和渲染。

Ramda JS NPM（開發者使用指南）：圖 3 - IronPDF for Node.js：Node.js 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";