JavaScript / TypeScript 클라이언트

JavaScript / TypeScript 클라이언트

Weaviate JavaScript/TypeScript 클라이언트의 공식 문서예요. 현재 최신 TypeScript 클라이언트 버전은 v3.14.0이고, 저장소는 weaviate/typescript-client, 레퍼런스 매뉴얼은 여기에서 볼 수 있어요. Node.js 환경에서 Weaviate를 다룰 때 씁니다.

출처: 공식문서

설치

패키지 설치와 클라이언트 임포트

v3 클라이언트는 ES Modules를 사용해요. 문서의 예시 코드 대부분도 ES Module 스타일이에요. CommonJS 호환이 필요하면 CommonJS 임포트 스타일을 쓰면 됩니다.

import weaviate from "weaviate-client";

Vectorizer API 변경 사항 (v3.8.0)

Weaviate JS/TS 클라이언트 v3.8.0부터 컬렉션 생성 시 벡터라이저 구성 API에 여러 변경 사항이 있어요. 컬렉션을 만들 때 벡터라이저를 구성하는 방식이 달라졌으므로 문서의 컬렉션 생성 예시를 최신 버전 기준으로 확인하세요.

v2 클라이언트 지원 종료

Weaviate JavaScript/TypeScript 클라이언트 v2는 deprecated되어 더 이상 쓰지 않아야 해요. v2 문서가 필요하다면 문서 아카이브를 확인하세요.

참고로 TypeScript 클라이언트가 2023-03-17에 기존 JavaScript 클라이언트를 대체했어요.

릴리스

릴리스는 Weaviate Database 버전과 함께 매핑돼요. 예를 들어 Weaviate Database 1.38.x(2026-06-05 출시)에는 TypeScript 3.14.x가, 1.37.x(2026-04-16)에는 3.13.x가 대응돼요. 최신 릴리스는 typescript-client GitHub 저장소에서 확인할 수 있어요.

더 알아보기 (Learn more)