linq.js

highheat — Tue, 12 May 2026 12:35:33 +0900

JavaScript에서 C# LINQ처럼 데이터 다루기 - linq.js 정리

업무 시스템이나 프론트엔드 개발을 하다 보면 배열 데이터에 대해 조회, 정렬, 그룹화, 집계 같은 처리를 많이 하게 된다.

JavaScript에서는 기본적으로 map, filter, reduce 같은 메서드를 제공하지만,
복잡한 데이터 처리에서는 코드가 길어지고 가독성이 떨어지는 경우가 있다.

이럴 때 사용할 수 있는 라이브러리 중 하나가 linq.js이다.

1. linq.js란?

linq.js는 .NET의 LINQ(Language Integrated Query)를 JavaScript에서 사용할 수 있도록 만든 라이브러리이다.

배열, 객체, 문자열 등의 데이터를 Enumerable 객체로 감싼 뒤 다음과 같은 메서드를 체이닝 방식으로 사용할 수 있다.

Where
Select
GroupBy
Join
OrderBy
Sum
Average
Distinct

즉, JavaScript 데이터를 SQL이나 C# LINQ처럼 선언적으로 다룰 수 있게 해주는 도구라고 볼 수 있다.

2. 현재 기준 저장소

linq.js는 원래 neuecc/linq.js 프로젝트로 시작되었다.

하지만 원본 저장소는 2019년에 archive 되었고 현재는 유지보수되지 않는다.

현재는 mihaifm/linq fork를 기준으로 사용하는 것이 좋다.

설치

npm install linq

ES Module 방식

import Enumerable from "linq";

CommonJS 방식

CommonJS 환경에서는 버전 3 사용이 안내되어 있다.

npm install linq@3

const Enumerable = require("linq");

3. 기본 사용법

linq.js의 기본 흐름은 다음과 같다.

Enumerable.from(데이터)
  .where(조건)
  .select(변환)
  .toArray();

예제:

import Enumerable from "linq";

const result = Enumerable.from([1, 2, 3, 4, 5, 6])
  .where(x => x % 2 === 0)
  .select(x => x * 10)
  .toArray();

console.log(result);

실행 결과:

[20, 40, 60]

4. JavaScript 기본 배열 메서드와 비교

JavaScript 기본 방식

const users = [
  { id: 1, name: "Kim", dept: "IT", age: 30 },
  { id: 2, name: "Lee", dept: "HR", age: 25 },
  { id: 3, name: "Park", dept: "IT", age: 35 }
];

const result = users
  .filter(user => user.dept === "IT")
  .map(user => user.name);

console.log(result);

결과:

["Kim", "Park"]

linq.js 방식

import Enumerable from "linq";

const result = Enumerable.from(users)
  .where(user => user.dept === "IT")
  .select(user => user.name)
  .toArray();

console.log(result);

결과:

["Kim", "Park"]

단순한 filter, map 정도는 JavaScript 기본 메서드가 더 간단하다.

하지만 다음과 같은 처리가 많아지면 linq.js가 더 읽기 쉬워질 수 있다.

GroupBy
Join
OrderBy
Distinct
Sum
Average

5. 정렬(OrderBy)

const users = [
  { name: "Kim", dept: "IT", age: 30 },
  { name: "Lee", dept: "HR", age: 25 },
  { name: "Park", dept: "IT", age: 35 }
];

const result = Enumerable.from(users)
  .orderBy(user => user.dept)
  .thenByDescending(user => user.age)
  .select(user => ({
    name: user.name,
    dept: user.dept,
    age: user.age
  }))
  .toArray();

console.log(result);

6. 그룹화(GroupBy)

부서별 인원 수를 구하는 예제이다.

const users = [
  { id: 1, name: "Kim", dept: "IT" },
  { id: 2, name: "Lee", dept: "HR" },
  { id: 3, name: "Park", dept: "IT" }
];

const result = Enumerable.from(users)
  .groupBy(
    user => user.dept,
    user => user,
    (dept, group) => ({
      dept,
      count: group.count()
    })
  )
  .toArray();

console.log(result);

결과:

[
  { dept: "IT", count: 2 },
  { dept: "HR", count: 1 }
]

7. 합계(Sum)

const orders = [
  { item: "A", qty: 2, price: 1000 },
  { item: "B", qty: 1, price: 3000 },
  { item: "C", qty: 5, price: 500 }
];

const total = Enumerable.from(orders)
  .sum(order => order.qty * order.price);

console.log(total);

결과:

8. Join 예제

두 배열을 조인하는 예제이다.

const users = [
  { id: 1, name: "Kim", deptId: "D01" },
  { id: 2, name: "Lee", deptId: "D02" },
  { id: 3, name: "Park", deptId: "D01" }
];

const departments = [
  { id: "D01", name: "개발팀" },
  { id: "D02", name: "인사팀" }
];

const result = Enumerable.from(users)
  .join(
    departments,
    user => user.deptId,
    dept => dept.id,
    (user, dept) => ({
      userName: user.name,
      deptName: dept.name
    })
  )
  .toArray();

console.log(result);

결과:

[
  { userName: "Kim", deptName: "개발팀" },
  { userName: "Lee", deptName: "인사팀" },
  { userName: "Park", deptName: "개발팀" }
]

9. 지연 평가(Lazy Evaluation)

linq.js의 중요한 특징 중 하나는 lazy evaluation(지연 평가)이다.

where, select 같은 중간 연산은 즉시 실행되지 않는다.

실제로는 toArray(), first(), count() 같은 최종 연산이 호출될 때 평가된다.

const query = Enumerable.from([1, 2, 3, 4, 5])
  .where(x => {
    console.log("where:", x);
    return x % 2 === 0;
  })
  .select(x => {
    console.log("select:", x);
    return x * 10;
  });

console.log("아직 실행 안 됨");

const result = query.toArray();

console.log(result);

이런 구조 덕분에 중간 배열 생성을 줄일 수 있다.

10. JavaScript 기본 기능과의 차이

JavaScript 자체도 이미 강력한 배열 메서드를 제공한다.

array.filter(...)
array.map(...)
array.reduce(...)
array.find(...)
array.some(...)
array.every(...)

따라서 단순 배열 처리만 한다면 굳이 linq.js가 필요하지 않을 수도 있다.

하지만 다음과 같은 경우에는 유용하다.

C# LINQ에 익숙한 개발자가 JavaScript를 다룰 때
SQL 스타일 데이터 처리를 선호할 때
GroupBy, Join, Sum 같은 처리가 많은 경우
업무 시스템에서 조회 데이터를 가공하는 경우

11. 주의할 점

1) 최신 JavaScript 기능과 비교 필요

최근 JavaScript는 기본 배열 메서드가 매우 강력하다.

단순 데이터 처리라면 기본 메서드만으로도 충분한 경우가 많다.

2) 번들 크기 고려

프론트엔드 프로젝트에서는 라이브러리 추가에 따른 번들 크기 증가를 고려해야 한다.

3) 모듈 방식 확인 필요

최신 npm 패키지는 ES Module 기준이다.

Node.js 환경에서는 CommonJS 여부를 확인해야 한다.

12. 정리

linq.js는 JavaScript에서 C# LINQ 스타일의 데이터 처리를 가능하게 해주는 라이브러리이다.

단순 배열 처리라면 JavaScript 기본 메서드가 더 간단할 수 있다.

하지만 다음과 같은 상황에서는 상당히 유용하다.

복잡한 데이터 가공
그룹화 및 집계
SQL 스타일 처리
업무 시스템 데이터 변환
C# 개발자의 JavaScript 작업

특히 ERP, 통계 화면, 조회 데이터 가공처럼
JSON 데이터를 화면용으로 재구성하는 작업에서 꽤 편리하게 사용할 수 있다.

참고 링크

원본 프로젝트

https://github.com/neuecc/linq.js

현재 유지보수 fork

https://github.com/mihaifm/linq

npm

https://www.npmjs.com/package/linq

CFP Quarterfinal: Texas Longhorns vs. Arizona State Sun Devils

highheat — Sun, 27 Apr 2025 20:28:25 +0900

U2 Live in Concert - Sphere, Las Vegas - February 9, 2024

highheat — Tue, 18 Feb 2025 12:15:53 +0900

MVP Josh Allen

highheat — Fri, 7 Feb 2025 15:21:55 +0900

빌스 승리!!!

highheat — Mon, 20 Jan 2025 12:47:41 +0900

윈도우환경의 vscode에서 빌드시 bash에서 실행

highheat — Fri, 13 Sep 2024 10:32:10 +0900

msys2를 설치하고 윈도우에서 gcc로 개발환경을 구성하다가 맞지하는 문제입니다.

`pkg-config --cflags --libs gtk4`

이렇게 task.json에서 args에 추가해서 빌드중 에러가 발생합니다.

해결책은 기본 쉘인 cmd.exe 대신 msys2에 있는 bash.exe를 이용해서 실행하는것입니다.

{
	"label": "Build GTK4 App in MSYS2 shell",
    "type": "shell",
    "command": "C:/msys64/usr/bin/bash.exe",  // MSYS2 쉘 실행
    "args": [
    	"-c",  // 쉘 명령 실행
        "gcc -fdiagnostics-color=always -g '${file}' -o '${fileDirname}/${fileBasenameNoExtension}.exe' $(pkg-config --cflags --libs gtk4)"
    ],
    "group": "build",
    "problemMatcher": ["$gcc"],
    "options": {
    	"cwd": "${workspaceFolder}"  // 작업 디렉토리 설정
    }
}

Pycharm에서 conda 인터프리터 설정

highheat — Wed, 10 Jul 2024 14:32:58 +0900

File -> Settings를 선택

Python Interpreter -> Add Interpreter

Conda Environment -> Conda Executable에서 conda.exe선택 -> Use existing environment에서 사용할 가상환경 선택

Pantera - Becoming

highheat — Thu, 31 Aug 2023 21:27:49 +0900

U2 New Year's Day live 1983 Germany

highheat — Thu, 31 Aug 2023 21:22:36 +0900

Dave Lombardo -- War Ensemble -- Yankee Stadium

highheat — Thu, 31 Aug 2023 21:15:07 +0900

Where The Streets Have No Name