gweb - GitLite

KO | EN

gitlite — search

#javascript #python #typescript #android #machine-learning #rust #linux #macos #windows #awesome #awesome-list #vue #security #mcp

gweb

(★ 225)

🌐 Interact with browser from Go. Manually crafted WebAPI interoperation library.

파일 탐색기

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

- - main.yml
- settings.json
- analyser_node.go
- audio_context.go
- audio_node.go
- audio_param.go
- biquad_filter.go
- destination_node.go
- gain_node.go
- media_stream.go
- media_stream_source_node.go
- oscillator.go
- value.go
- context.go
- context2d.go
- line.go
- rectangle.go
- shadow.go
- text.go
- style_declaration.go
- - main.go
- - main.go
- - ball.go
  - ball_test.go
  - brick.go
  - bricks.go
  - game.go
  - main.go
  - main_test.go
  - platform.go
  - settings.go
  - shapes.go
  - state.go
  - test.sh
  - text_block.go
  - vector.go
- - main.go
- - main.go
- - index.html
  - loader.js
  - style.css
- - main.go
- - main.go
- - main.go
- - main.go
- - key.go
  - keyboard.go
  - main.go
  - sound.go
- - main.go
- - main.go
- - main.go
- - main.go
- build.sh
- build_all.py
- index.html.j2
- index.yml
- README.md
- run.sh
- canvas.go
- console.go
- console_test.go
- document.go
- document_test.go
- element.go
- element_test.go
- embed.go
- event.go
- event_target.go
- html_element.go
- http_request.go
- http_request_test.go
- media_devices.go
- navigator.go
- node.go
- promise.go
- screen.go
- value.go
- window.go
- window_test.go
.editorconfig
.gitignore
.markdownlint.yaml
generate_refs.py
go.mod
go.sum
LICENSE
netlify.toml
README.md
refs.md
requirements.txt
Taskfile.yml
tools.go

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/life4/gweb

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

cd gweb

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

2. Python

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Python 3 설치 시 'Add Python to PATH' 옵션을 꼭 체크하세요 (Windows).

pip install -r requirements.txt

requirements.txt 등에 명시된 파이썬 라이브러리를 설치합니다.

python <실행할 파일명>.py # README에서 정확한 실행 파일명을 확인하세요

파이썬 스크립트(또는 모듈)를 실행합니다.

✅ 에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.

3. Go

보통

사전 준비물

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

go build ./...

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

go run .

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

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# GWeb: golang + js + wasm

**gweb** -- strictly typed [WebAPI](https://en.wikipedia.org/wiki/Web_API) library on top of [syscall/js](https://golang.org/pkg/syscall/js/). Like [flow](https://github.com/facebook/flow) or [TypeScript](https://www.typescriptlang.org/) but for Go. You need it if you want to interact with browser from [wasm-compiled](https://github.com/golang/go/wiki/WebAssembly) Go program.

+ Examples: [gweb.orsinium.dev](https://gweb.orsinium.dev/)
+ Mapping of JS Web API to GWeb functions: [refs.md](./refs.md)

## Features

+ **Strictly typed**. It's a wrapper around `syscall/js` that helps you to avoid runtime errors (you'll get them a lot with raw `syscall/js`).
+ **Backward compatible**. Almost every type is a wrapper around `js.Value`. So if something missed, you can always fall back to the classic `syscall/js` calls.
+ **Hand crafted**. It's hard to make a usable autogeneration of WebAPI since Go is a strictly typed language without union types. So we carefully translated everything while applying Go best practices.
+ **Cleaned up**. The library provides only useful methods and attributes from WebAPI. No obsolete and deprecated methods, no experimental APIs that are only supported by a few engines. Only what we really need right now.
+ **Almost the same API as in JS**. If you have experience with [vanilla JS](https://stackoverflow.com/a/20435744), you have almost learnt everything about the libray.
+ **But better**. WebAPI has a long history of incremental changes and spaces for unimplemented dreams. However, we can see the full picture to provide a better experience and more namespaces.
+ **Documented**. Every method is documented to save your time and reduce googling.

## Installation

```bash
GOOS=js GOARCH=wasm go get github.com/life4/gweb
```

If you're using VSCode, it's recommend to create a `.vscode/settings.json` file in your project with the following content:

```json
{
    "go.toolsEnvVars": {
        "GOARCH": "wasm",
        "GOOS": "js",
    },
    "go.testEnvVars": {
        "GOARCH": "wasm",
        "GOOS": "js",
    },
}
```

## Error handling

In the beautiful JS world anything at any time can be `null` or `undefined`. Check it when you're not sure:

```go
doc := web.GetWindow().Document()
el := doc.Element("some-element-id")
if el.Type() == js.TypeNull {
    // handle error
}
```

## Missed API

If something is missed, use `syscall/js`-like methods (`Get`, `Set`, `Call` etc):

```go
doc := web.GetWindow().Document()
el := doc.Element("some-element-id")
name = el.Get("name").String()
```

## Packages

GWeb is a collection of a few packages:

+ `web` ([docs](https://pkg.go.dev/github.com/life4/gweb/web?tab=doc)) -- window, manipulations with DOM.
+ `audio` ([docs](https://pkg.go.dev/github.com/life4/gweb/audio?tab=doc)) -- [Web Audio API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API). Use `web.GetWindow().AudioContext()` as an entry point.
+ `canvas` ([docs](https://pkg.go.dev/github.com/life4/gweb/canvas?tab=doc)) -- canvas-related objects. Use `web.GetWindow().Document().CreateCanvas()` to get started.
+ `css` ([docs](https://pkg.go.dev/github.com/life4/gweb/css?tab=doc)) -- manage styles for HTML elements.

## Contributing

Contributions are welcome! GWeb is a Open-Source project and you can help to make it better. Some ideas what can be improved:

+ Every function and object should have short description based on [MDN Web API docs](https://developer.mozilla.org/en-US/docs/Web/API). Some descriptions are missed.
+ Also, every function that calls a Web API method should have a link in docs for that method.
+ Typos are very possible, don't be shy to fix it if you've spotted one.
+ More objects and methods? Of course! Our goal is to cover everything in WebAPI! Well, excluding deprecated things. See [Features](#features) section to get feeling what should be there.
+ Found a bug? Fix it!

And even if you don't have spare time for making PRs, you still can help by talking to your friends and subscribers about GWeb. Thank you :heart:

## Similar projects

+ [webapi](https://github.com/gowebapi/webapi/) -- bindings that autogenerated from [WebIDL](https://heycam.github.io/webidl/).
+ [godom](https://github.com/siongui/godom) -- bindings on top of [gopherjs](github.com/gopherjs/gopherjs/).