패키지 함수

패키지 수준 함수는 일회성 호출 시나리오에 적합하며, 내부적으로 sync.Pool을 사용하여 Processor 를 재사용하므로 라이프사이클을 수동으로 관리할 필요가 없습니다. 참고: 풀링된 Processor 는 캐시와 감사 보존을 비활성화합니다; 캐시/통계/감사가 필요하면 html.New로 전용 Processor 를 생성하세요.

콘텐츠 추출

Extract

HTML 바이트에서 콘텐츠를 추출하여 완전한 Result를 반환합니다.

func Extract(htmlBytes []byte, cfg ...Config) (*Result, error)

매개변수:

매개변수	타입	설명
`htmlBytes`	`[]byte`	HTML 콘텐츠
`cfg`	`...Config`	선택적 설정, 최대 1 개

예시:

result, err := html.Extract(data)
if err != nil {
    log.Fatal(err)
}
fmt.Println(result.Title, result.Text)

ExtractFromFile

HTML 파일에서 콘텐츠를 추출합니다.

func ExtractFromFile(filePath string, cfg ...Config) (*Result, error)

텍스트 추출

ExtractText

순수 텍스트 콘텐츠만 추출합니다.

func ExtractText(htmlBytes []byte, cfg ...Config) (string, error)

ExtractTextFromFile

파일에서 순수 텍스트를 추출합니다.

func ExtractTextFromFile(filePath string, cfg ...Config) (string, error)

컨텍스트 버전

모든 함수는 context.Context가 포함된 버전을 지원하여 취소 및 타임아웃 제어에 사용합니다:

함수	시그니처
`ExtractWithContext`	`(ctx context.Context, htmlBytes []byte, cfg ...Config) (*Result, error)`
`ExtractFromFileWithContext`	`(ctx context.Context, filePath string, cfg ...Config) (*Result, error)`
`ExtractTextWithContext`	`(ctx context.Context, htmlBytes []byte, cfg ...Config) (string, error)`
`ExtractTextFromFileWithContext`	`(ctx context.Context, filePath string, cfg ...Config) (string, error)`

ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()

result, err := html.ExtractWithContext(ctx, data)

출력 형식

함수	시그니처	설명
`ExtractToMarkdown`	`(htmlBytes []byte, cfg ...Config) (string, error)`	HTML → Markdown
`ExtractToMarkdownFromFile`	`(filePath string, cfg ...Config) (string, error)`	파일 → Markdown
`ExtractToMarkdownWithContext`	`(ctx context.Context, htmlBytes []byte, cfg ...Config) (string, error)`	컨텍스트 포함
`ExtractToMarkdownFromFileWithContext`	`(ctx context.Context, filePath string, cfg ...Config) (string, error)`	파일 + 컨텍스트
`ExtractToJSON`	`(htmlBytes []byte, cfg ...Config) ([]byte, error)`	HTML → JSON
`ExtractToJSONFromFile`	`(filePath string, cfg ...Config) ([]byte, error)`	파일 → JSON
`ExtractToJSONWithContext`	`(ctx context.Context, htmlBytes []byte, cfg ...Config) ([]byte, error)`	컨텍스트 포함
`ExtractToJSONFromFileWithContext`	`(ctx context.Context, filePath string, cfg ...Config) ([]byte, error)`	파일 + 컨텍스트

자세한 사용법과 예시는 출력 형식을 참조하세요.

링크 추출

함수	시그니처	설명
`ExtractAllLinks`	`(htmlBytes []byte, cfg ...Config) ([]LinkResource, error)`	모든 링크 추출
`ExtractAllLinksFromFile`	`(filePath string, cfg ...Config) ([]LinkResource, error)`	파일에서 링크 추출
`ExtractAllLinksWithContext`	`(ctx context.Context, htmlBytes []byte, cfg ...Config) ([]LinkResource, error)`	컨텍스트 포함
`ExtractAllLinksFromFileWithContext`	`(ctx context.Context, filePath string, cfg ...Config) ([]LinkResource, error)`	파일 + 컨텍스트

자세한 사용법과 예시는 링크 추출을 참조하세요.

배치 처리

함수	시그니처	설명
`ExtractBatch`	`(htmlContents [][]byte, cfg ...Config) *BatchResult`	배치 추출
`ExtractBatchWithContext`	`(ctx context.Context, htmlContents [][]byte, cfg ...Config) *BatchResult`	컨텍스트 포함
`ExtractBatchFiles`	`(filePaths []string, cfg ...Config) *BatchResult`	배치 파일 추출
`ExtractBatchFilesWithContext`	`(ctx context.Context, filePaths []string, cfg ...Config) *BatchResult`	파일 + 컨텍스트

자세한 사용법과 예시는 배치 처리를 참조하세요.

패키지 함수 ​

콘텐츠 추출 ​

Extract ​

ExtractFromFile ​

텍스트 추출 ​

ExtractText ​

ExtractTextFromFile ​

컨텍스트 버전 ​

출력 형식 ​

링크 추출 ​

배치 처리 ​