HTTP/2 Server Push Recipe

Requires go1.8+

How to send web assets using HTTP/2 server push?

Step 1: Generate a self-signed X.509 TLS certificate

Step 2: Register a route to serve web assets

  1. e.Static("/", "static")

Step 3: Create a handler to serve index.html and push it’s dependencies

  1. e.GET("/", func(c echo.Context) (err error) {
  2.   pusher, ok := c.Response().Writer.(http.Pusher)
  3.   if ok {
  4.     if err = pusher.Push("/app.css", nil); err != nil {
  5.       return
  6.     }
  7.     if err = pusher.Push("/app.js", nil); err != nil {
  8.       return
  9.     }
  10.     if err = pusher.Push("/echo.png", nil); err != nil {
  11.       return
  12.     }
  13.   }
  14.   return c.File("index.html")
  15. })

If http.Pusher is supported, web assets are pushed; otherwise, client makes separate requests to get them.

Step 4: Configure TLS server using cert.pem and key.pem

  1. e.StartTLS(":1323", "cert.pem", "key.pem")

Step 5: Start the server and browse to https://localhost:1323

  1. Protocol: HTTP/2.0
  2. Host: localhost:1323
  3. Remote Address: [::1]:60288
  4. Method: GET
  5. Path: /

Source Code

index.html

  1.  

server.go

  1.  

Maintainers