goquery - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #typescript #golang #go #linux #macos #awesome #kubernetes #awesome-list #openai #mcp

goquery

(★ 14,977)

그 j라는 것과 약간 비슷하지만, Go로 만들어졌습니다.

파일 탐색기

최종 버전 다운로드 (.zip)

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/PuerkitoBio/goquery

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd goquery

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Go

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Go Go 언어 컴파일러 및 도구 모음입니다.

go build ./...

Go 프로그램을 컴파일해 실행 파일을 만듭니다.

go run .

따로 빌드하지 않고 바로 Go 프로그램을 실행합니다.

✅ 빌드가 에러 없이 끝나면 성공입니다. go run . 을 썼다면 터미널 출력을 확인하세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# goquery - Go 언어로 즐기는 그 유명한 j-것(?) 같은 라이브러리
[![Build Status](https://github.com/PuerkitoBio/goquery/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/PuerkitoBio/goquery/actions)
[![Go Reference](https://pkg.go.dev/badge/github.com/PuerkitoBio/goquery.svg)](https://pkg.go.dev/github.com/PuerkitoBio/goquery)
[![Sourcegraph Badge](https://sourcegraph.com/github.com/PuerkitoBio/goquery/-/badge.svg)](https://sourcegraph.com/github.com/PuerkitoBio/goquery?badge)
goquery는 [Go 언어][go]에 [jQuery][]와 유사한 문법과 기능 세트를 제공합니다. Go의 [net/html 패키지][html]와 CSS Selector 라이브러리인 [cascadia][]를 기반으로 합니다. net/html 파서는 완전한 기능을 갖춘 DOM 트리가 아니라 노드를 반환하기 때문에, jQuery의 상태 비저장(stateful) 조작 함수(height(), css(), detach() 등)는 제외되었습니다.
또한 net/html 파서는 UTF-8 인코딩을 요구하므로 goquery 역시 마찬가지입니다. 소스 문서가 UTF-8로 인코딩된 HTML을 제공하는지 확인하는 것은 호출자의 책임입니다. 이를 수행하는 다양한 방법에 대해서는 [위키][wiki]를 참조하세요.
문법 측면에서 가능한 한 jQuery에 가깝게 설계되었으며, 가능하면 동일한 함수 이름을 사용하고 친숙하고 편안한 메서드 체이닝 인터페이스를 제공합니다. jQuery는 극도로 인기 있는 라이브러리이므로, (Go의 `fmt` 패키지와 같은 정신으로) 새롭게 시작하기보다는 그 API를 따르는 편이 유사한 HTML 조작 라이브러리를 작성하는 데 더 낫다고 판단했습니다. 일부 메서드가 다소 직관적이지 않더라도 말이죠(인덱스를 반환하는 [index()][index] 너를 말하는 거야...).
## 목차
\* [설치](#installation)
\* [변경 내역](#changelog)
\* [API](#api)
\* [예제](#examples)
\* [관련 프로젝트](#related-projects)
\* [지원](#support)
\* [라이선스](#license)
## 설치
필요한 Go 버전:
\* goquery `v1.12.0` 버전부터는 의존성 문제로 Go 1.25 이상이 필요합니다.
\* goquery `v1.11.0` 버전부터는 의존성 문제로 Go 1.24 이상이 필요합니다.
\* goquery `v1.10.0` 버전부터는 함수 기반 이터레이터 사용으로 인해 Go 1.23 이상이 필요합니다.
\* goquery `v1.9.0` 버전은 제네릭 사용으로 인해 Go 1.18 이상이 필요합니다.
\* 이전 goquery 버전은 `net/html` 의존성 때문에 Go 1.1 이상이 필요했습니다.
goquery의 지속적인 개발은 최신 2개의 Go 버전을 기준으로 테스트됩니다.
$ go get github.com/PuerkitoBio/goquery
(선택 사항) 단위 테스트 실행 방법:
$ cd $GOPATH/src/github.com/PuerkitoBio/goquery
$ go test
(선택 사항) 벤치마크 실행 방법 (경고: 몇 분 정도 소요됩니다):
$ cd $GOPATH/src/github.com/PuerkitoBio/goquery
$ go test -bench=".\*"
## 변경 내역
\*\*현재 goquery의 API는 안정화되었으며 하위 호환성이 깨지지 않습니다.\*\*
\* \*\*2026-03-15 (v1.12.0)\*\* : `go.mod` 의존성 업데이트, 테스트 매트릭스에 go1.26 추가, \*\*이제 goquery는 Go 버전 1.25 이상이 필요합니다\*\*.
\* \*\*2025-11-16 (v1.11.0)\*\* : `go.mod` 의존성 업데이트, 테스트 매트릭스에 go1.25 추가, \*\*이제 goquery는 Go 버전 1.24 이상이 필요합니다\*\*.
\* \*\*2025-04-11 (v1.10.3)\*\* : `go.mod` 의존성 업데이트, 소소한 최적화 (기여: [@myxzlpltk](https://github.com/myxzlpltk)).
\* \*\*2025-02-13 (v1.10.2)\*\* : `go.mod` 의존성 업데이트, 테스트 매트릭스에 go1.24 추가.
\* \*\*2024-12-26 (v1.10.1)\*\* : `go.mod` 의존성 업데이트.
\* \*\*2024-09-06 (v1.10.0)\*\* : `\*Selection` 객체에서 `for..range` 루프에 사용할 수 있는 이터레이터를 제공하는 `EachIter` 추가. \*\*이제 goquery는 Go 버전 1.23 이상이 필요합니다\*\* (기여: [@amikai](https://github.com/amikai)).
\* \*\*2024-09-06 (v1.9.3)\*\* : `go.mod` 의존성 업데이트.
\* \*\*2024-04-29 (v1.9.2)\*\* : `go.mod` 의존성 업데이트.
\* \*\*2024-02-29 (v1.9.1)\*\* : `Map` 함수 및 `Selection.Map` 메서드의 메모리 할당 및 성능 개선, cascadia 차이점에 대한 문서 개선 (기여: [@jwilsson](https://github.com/jwilsson)).
\* \*\*2024-02-22 (v1.9.0)\*\* : 제네릭 `Map` 함수 추가, \*\*이제 goquery는 Go 버전 1.18 이상이 필요합니다\*\* (기여: [@Fesaa](https://github.com/Fesaa)).
\* \*\*2023-02-18 (v1.8.1)\*\* : `go.mod` 의존성 업데이트

ndencies, CI 워크플로우 업데이트.
\* \*\*2021-10-25 (v1.8.0)\*\* : `Selection`을 `io.Writer`에 렌더링하기 위한 `Render` 함수 추가 ([@anthonygedeon](https://github.com/anthonygedeon) 님께 감사드립니다).
\* \*\*2021-07-11 (v1.7.1)\*\* : go.mod 의존성 업데이트 및 dependabot 설정 추가 ([@jauderho](https://github.com/jauderho) 님께 감사드립니다).
\* \*\*2021-06-14 (v1.7.0)\*\* : 첫 번째 일치 항목 선택을 최적화하기 위한 `Single` 및 `SingleMatcher` 함수 추가 ([@gdollardollar](https://github.com/gdollardollar) 님께 감사드립니다).
\* \*\*2021-01-11 (v1.6.1)\*\* : Element가 아닌 노드를 포함하는 `Selection`에서 `{Prepend,Append,Set}Html` 호출 시 패닉이 발생하는 문제 수정.
\* \*\*2020-10-08 (v1.6.0)\*\* : HTML 문자열을 다루는 모든 함수(`AfterHtml`, `AppendHtml` 등)에서 컨테이너 노드의 컨텍스트로 HTML을 파싱합니다. 이 작업에 기여해 주신 [@thiemok][thiemok]님과 [@davidjwilkins][djw]님께 감사드립니다.
\* \*\*2020-02-04 (v1.5.1)\*\* : 모듈 의존성 업데이트.
\* \*\*2018-11-15 (v1.5.0)\*\* : Go 모듈 지원 (@Zaba505 님께 감사드립니다).
\* \*\*2018-06-07 (v1.4.1)\*\* : `NewDocumentFromReader` 예제 추가.
\* \*\*2018-03-24 (v1.4.0)\*\* : `NewDocument(url)` 및 `NewDocumentFromResponse(response)` 함수를 사용 중단(deprecated) 처리합니다.
\* \*\*2018-01-28 (v1.3.0)\*\* : 선택 영역의 끝까지 지정할 수 있는 `ToEnd` 상수를 `Slice`에 추가합니다 (문제를 제기해 주신 @davidjwilkins 님께 감사드립니다).
\* \*\*2018-01-11 (v1.2.0)\*\* : `AddBack\*` 추가 및 `AndSelf` 사용 중단(deprecated) 처리 (@davidjwilkins 님께 감사드립니다).
\* \*\*2017-02-12 (v1.1.0)\*\* : `SetHtml` 및 `SetText` 추가 (@glebtv 님께 감사드립니다).
\* \*\*2016-12-29 (v1.0.2)\*\* : `Selection.Text`의 메모리 할당 최적화 (@radovskyb 님께 감사드립니다).
\* \*\*2016-08-28 (v1.0.1)\*\* : 대용량 문서에 대한 성능 최적화.
\* \*\*2016-07-27 (v1.0.0)\*\* : 버전 1.0.0 태그 지정.
\* \*\*2016-06-15\*\* : 잘못된 셀렉터 문자열은 내부적으로 어떤 노드와도 일치하지 않는 `Matcher` 구현체로 컴파일됩니다(패닉 대신). 따라서 예를 들어 `doc.Find("~")`는 빈 `\*Selection` 객체를 반환합니다.
\* \*\*2016-02-02\*\* : DOM의 `nodeName` 속성과 유사한 `NodeName` 유틸리티 함수를 추가합니다. 이는 선택 영역의 첫 번째 요소의 태그 이름과, 요소가 아닌 노드의 기타 관련 값을 반환합니다(자세한 내용은 [doc][] 참고). DOM의 `outerHTML` 속성과 유사한 `OuterHtml` 유틸리티 함수를 추가합니다(`Selection`의 기존 `Html` 메서드와의 일관성을 위해 소문자를 섞은 `OuterHtml`로 명명).
\* \*\*2015-04-20\*\* : 속성 값이 없을 때 기본값이나 속성 값을 반환하는 `AttrOr` 헬퍼 메서드 추가. [piotrkowalczuk][piotr] 님께 감사드립니다.
\* \*\*2015-02-04\*\* : 더 많은 조작(manipulation) 함수 추가 - Prepend\* - [Andrew Stone][thatguystone] 님께 다시 한번 감사드립니다.
\* \*\*2014-11-28\*\* : 더 많은 조작 함수 추가 - ReplaceWith\*, Wrap\*, Unwrap - [Andrew Stone][thatguystone] 님께 다시 한번 감사드립니다.
\* \*\*2014-11-07\*\* : 조작 함수들([Andrew Stone][thatguystone] 님께 감사드립니다)과 셀렉터 문자열 대신 컴파일된 cascadia 셀렉터를 받아 goquery가 `cascadia.MustCompile` 호출을 통해 발생시킬 수 있는 잠재적 패닉을 방지하는 `\*Matcher` 함수들을 추가합니다. 이를 통해 더 나은 성능(셀렉터를 한 번만 컴파일하고 재사용 가능)과 더 관용적인 에러 처리(오랫동안 저를 괴롭혔던 패닉 복구 대신 cascadia의 컴파일 에러를 직접 처리할 수 있음)가 가능해집니다. 실제로 기대되는 타입은 `cascadia.Selector`가 구현하는 `Matcher` 인터페이스입니다. 다른 매처 구현체도 사용할 수 있습니다.
\* \*\*2014-11-06\*\* : net/html의 임포트 경로를 golang.org/x/net/html로 변경합니다 (https://groups.google.com/forum/#!topic/golang-nuts/eD8dh3T9yyA 참고). goquery와 함께 `html.Node`를 호출할 때 새 임포트 경로를 사용하도록 코드를 업데이트해야 합니다.
\* \*\*v0.3.2\*\* : io.Reader로부터 goquery 문서를 생성할 수 있는 `NewDocumentFromReader()` 추가 (jweir 님께 감사드립니다).
\* \*\*v0.3.1\*\* : http 응답으로부터 goquery 문서를 생성할 수 있는 `NewDocumentFromResponse()` 추가 (assassingj 님께 감사드립니다).
\* \*\*v0.3.0\*\* : 반복을 탈출할 수 있는 `EachWithBreak()` 추가

n `Each()` 루프에서 false를 반환하여 중단할 수 있습니다. 이 함수는 기존 `Each()` 변경 시 하위 호환성이 깨지는 것을 방지하기 위해 추가되었습니다.
\* \*\*v0.2.1\*\* : [go.net/html이 Go1.0을 지원하게 됨에 따라][gonet] 이제 go-get이 가능해졌습니다 (이를 알려주신 @matrixik님께 감사드립니다).
\* \*\*v0.2.0\*\* : `Slice()`에서 음수 인덱스 지원을 추가했습니다. \*\*호환성 깨짐 변경(BREAKING CHANGE)\*\* `Document.Root`가 제거되었고, 이제 `Document` 자체가 `Selection`이 되었습니다(기존 `Document.Root`와 마찬가지로 루트 요소를 하나 가진 셀렉션입니다). jQuery의 Closest() 메서드를 추가했습니다.
\* \*\*v0.1.1\*\* : 리팩토링의 기준으로 사용할 벤치마크를 추가하고, 새로운 html 패키지의 연결 리스트 기능(Next/PrevSibling, FirstChild)을 사용하도록 Next...() 및 Prev...() 메서드를 리팩토링했습니다. 상당한 성능 향상(일부 경우 40% 이상)이 있었습니다.
\* \*\*v0.1.0\*\* : 최초 릴리스.
## API
goquery는 두 개의 구조체(`Document`, `Selection`)와 하나의 `Matcher` 인터페이스를 제공합니다. DOM 문서의 일부로 로드되어 해당 문서를 대상으로 동작하는 jQuery와 달리, goquery는 어떤 HTML 문서를 대상으로 해야 할지 알 수 없습니다. 따라서 이를 지정해 주어야 하며, `Document` 타입이 바로 그러한 역할을 합니다. `Document`는 조작할 초기 Selection 값으로 루트 문서 노드를 유지합니다.
jQuery에는 동일한 함수에 대해 여러 변형(인수 없음, 셀렉터 문자열 인수, jQuery 객체 인수, DOM 요소 인수 등)이 있는 경우가 많습니다. goquery에서는 가변 길이의 빈 인터페이스 인수를 받는 단일 메서드로 동일한 기능을 제공하는 대신, 다음과 같은 네이밍 컨벤션을 따르는 정적 타이핑 시그니처를 사용합니다.
\* jQuery 대응 함수를 인수 없이 호출할 수 있는 경우, 인수 없는 시그니처는 jQuery와 동일한 이름을 사용하며(예: `Prev()`), 셀렉터 문자열 인수를 받는 버전은 `XxxFiltered()`라고 부릅니다(예: `PrevFiltered()`)
\* jQuery 대응 함수가 하나의 인수를 \*\*반드시 요구\*\*하는 경우, 셀렉터 문자열 버전에는 jQuery와 동일한 이름을 사용합니다(예: `Is()`)
\* jQuery 객체를 인수로 받는 시그니처는 goquery에서 `XxxSelection()`으로 정의되며 `\*Selection` 객체를 인수로 받습니다(예: `FilterSelection()`)
\* jQuery에서 DOM 요소를 인수로 받는 시그니처는 goquery에서 `XxxNodes()`로 정의되며 `\*html.Node` 타입의 가변 인수를 받습니다(예: `FilterNodes()`)
\* jQuery에서 함수를 인수로 받는 시그니처는 goquery에서 `XxxFunction()`으로 정의되며 함수를 인수로 받습니다(예: `FilterFunction()`)
\* 셀렉터 문자열로 호출할 수 있는 goquery 메서드에는 `Matcher` 인터페이스를 받는 대응 버전이 있으며 `XxxMatcher()`로 정의됩니다(예: `IsMatcher()`)
jQuery에는 없지만 Go에서 유용한 유틸리티 함수들은 `\*Selection`의 메서드들과의 잠재적인 이름 충돌(jQuery 대응 동작을 위해 예약됨)을 피하기 위해 (`\*Selection`을 매개변수로 받는) 일반 함수로 구현되어 있습니다.
완전한 [패키지 참조 문서는 여기에서 확인할 수 있습니다][doc].
Cascadia의 셀렉터가 jQuery(Sizzle)에서 지원하는 모든 셀렉터와 반드시 일치하는 것은 아니라는 점에 유의하세요. 자세한 내용은 [cascadia 프로젝트][cascadia]를 참조하세요. 또한, 이 셀렉터들은 jQuery의 매처보다는 DOM의 `querySelectorAll`과 유사하게 작동합니다. 즉, 문맥적 매칭이라는 개념이 없습니다(이것이 의미하는 바에 대한 구체적인 예시는 [이 티켓](https://github.com/andybalholm/cascadia/issues/61)을 참조하세요). 실제로는 자주 문제가 되지 않지만 언급할 가치가 있는 부분입니다. 잘못된 셀렉터 문자열은 어떤 노드와도 매칭에 실패하는 `Matcher`로 컴파일됩니다. 셀렉터 문자열을 인수로 받는 다양한 함수의 동작은 이 사실로부터 도출됩니다. 예를 들어(여기서 `~`는 잘못된 셀렉터 문자열임):
\* 셀렉터 문자열이 아무것도 매칭하지 못하므로 `Find("~")`는 빈 셀렉션을 반환합니다.
\* 노드를 추가하지 못했기 때문에(셀렉터 문자열이 아무것도 매칭하지 못함), `Add("~")`는 원래 셀렉션과 동일한 노드들을 유지하는 새로운 셀렉션을 반환합니다.
\* 셀렉터 문자열이 아무것도 매칭하지 못하므로 `ParentsFiltered("~")`는 빈 셀렉션을 반환합니다.
\*

`ParentsUntil("~")`는 선택자 문자열이 최상단 요소에 도달하기 전에 멈출 요소를 찾지 못했기 때문에, 선택된 요소의 모든 부모를 반환합니다.
## 예제
[wiki][]에서 몇 가지 팁과 요령을 확인하세요.
example\_test.go 발췌:
```Go
package main
import (
"fmt"
"log"
"net/http"
"github.com/PuerkitoBio/goquery"
)
func ExampleScrape() {
// Request the HTML page.
res, err := http.Get("http://metalsucks.net")
if err != nil {
log.Fatal(err)
}
defer res.Body.Close()
if res.StatusCode != 200 {
log.Fatalf("status code error: %d %s", res.StatusCode, res.Status)
}
// Load the HTML document
doc, err := goquery.NewDocumentFromReader(res.Body)
if err != nil {
log.Fatal(err)
}
// Find the review items
doc.Find(".left-content article .post-title").Each(func(i int, s \*goquery.Selection) {
// For each item found, get the title
title := s.Find("a").Text()
fmt.Printf("Review %d: %s\n", i, title)
})
}
func main() {
ExampleScrape()
}
```
## 관련 프로젝트
- [Goq][goq], goquery과 구조체 태그 기반의 HTML 역직렬화 및 스크래핑 라이브러리.
- [andybalholm/cascadia][cascadia], goquery에서 사용하는 CSS 선택자 라이브러리.
- [suntong/cascadia][cascadiacli], cascadia CSS 선택자 라이브러리의 커맨드 라인 인터페이스로, 선택자 테스트에 유용합니다.
- [gocolly/colly](https://github.com/gocolly/colly), 번개처럼 빠르고 우수한 스크래핑 프레임워크
- [gnulnx/goperf](https://github.com/gnulnx/goperf), 정적 자산도 가져오는 웹사이트 성능 테스트 도구.
- [MontFerret/ferret](https://github.com/MontFerret/ferret), 선언형 웹 스크래핑.
- [tacusci/berrycms](https://github.com/tacusci/berrycms), 작성하기 쉬운 플러그인을 갖춘 모던하고 사용하기 간편한 CMS
- [Dataflow kit](https://github.com/slotix/dataflowkit), Gopher들을 위한 웹 스크래핑 프레임워크.
- [Geziyor](https://github.com/geziyor/geziyor), Go를 위한 빠르고 강력한 웹 크롤링 및 스크래핑 프레임워크. JS 렌더링 지원.
- [Pagser](https://github.com/foolin/pagser), goquery과 구조체 태그를 기반으로 하는 간단하고 쉽고 확장 가능하며 설정 가능한 HTML 파서-구조체 매퍼.
- [stitcherd](https://github.com/vhodges/stitcherd), CSS 선택자와 DOM 업데이트를 사용하는 서버 사이드 인클루드 서버.
- [goskyr](https://github.com/jakopako/goskyr), Go로 작성된 쉽게 설정 가능한 커맨드 라인 스크래퍼.
- [goGetJS](https://github.com/davemolk/goGetJS), JavaScript 파일을 추출, 검색 및 저장하기 위한 도구 (선택적 헤드리스 브라우저 지원).
- [fitter](https://github.com/PxyUp/fitter), JSON, XML, HTML 및 XPath 형식 페이지에서 값을 선택하기 위한 도구.
- [seltabl](github.com/conneroisu/seltabl), HTML에서 값을 추출하기 위한 ORM 유사 패키지 및 지원 언어 서버
## 지원
프로젝트를 지원할 수 있는 여러 가지 방법이 있습니다:
\* 사용해 주세요, 스타를 눌러주세요, 무언가를 만들어 주세요, 널리 알려주세요!
- 오픈소스이거나 공개적으로 볼 수 있는 무언가를 만들었다면, [관련 프로젝트](#related-projects) 섹션에 추가할 수 있도록 알려주세요!
\* 프로젝트 개선을 위한 이슈를 제기해 주세요 (참고: 문서 오타 및 명확화 요청도 이슈입니다!)
- 새로운 이슈를 열기 전에 기존 이슈를 먼저 검색해 주세요. 이미 다루어졌을 수 있습니다.
\* 풀 리퀘스트: 수정 사항이 아주 사소한 경우가 아니라면, 새 코드는 먼저 이슈에서 논의해 주세요.
- 새 코드가 테스트되었는지 확인해 주세요.
- 기존 코드를 유의해 주세요. 심각한 문제를 해결하는 것이 아니라면, 기존 코드를 깨트리는 PR은 거절될 확률이 높습니다.
\* 개발자 후원하기
- github의 레포지토리 상단에 있는 Github Sponsor 버튼을 확인하세요.
- 또는 아래의 BuyMeACoffee.com을 통해 후원할 수 있습니다.
[![Buy Me A Coffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/mna)
## 라이선스
[BSD 3-Clause license][bsd]를 따르며, [Go 언어][golic]와 동일합니다. Cascadia의 라이선스는 [여기][caslic]에 있습니다.
[jquery]: https://jquery.com/
[go]: https://go.dev/
[cascadia]: https://github.com/andybalholm/cascadia
[cascadiacli]: https://github.com/suntong/cascadia
[bsd]: https://opensource.org/licenses/BSD-3-Clause
[golic]: https://go.dev/LICENSE
[caslic]

: https://github.com/andybalholm/cascadia/blob/master/LICENSE
[doc]: https://pkg.go.dev/github.com/PuerkitoBio/goquery
[index]: https://api.jquery.com/index/
[gonet]: https://github.com/golang/net/
[html]: https://pkg.go.dev/golang.org/x/net/html
[wiki]: https://github.com/PuerkitoBio/goquery/wiki/Tips-and-tricks
[thatguystone]: https://github.com/thatguystone
[piotr]: https://github.com/piotrkowalczuk
[goq]: https://github.com/andrewstuart/goq
[thiemok]: https://github.com/thiemok
[djw]: https://github.com/davidjwilkins