View all our articles

Waiting for a custom element to be ready in Go with Net/HTTP

The wait_for parameter is one of the most powerful feature of PDFShift. It allows you to control when the document is ready to be converted to PDF.

For instance, you might need the wait_for parameter to wait on your charts to be visible.

It makes sense because from our engine point of view, all the resources are loaded so the conversion to PDF can be executed. But from your page stand point, even though everything is loaded, not everything is rendered!

So by using the wait_for parameter, you can tell PDFShift to wait for a specific condition to be true before allowing the conversion to happen.

That property expects a string which points to a global function.

For instance, if in your HTML page, you have the following script:

<script>
function isPageReady() {
    return document.getElementById('chart').clientHeight > 0;
}
</script>

You can set the wait_for parameter to isPageReady and PDFShift will wait for the isPageReady function to return true before converting the page to PDF.

package main

import (
    "bytes"
    "encoding/base64"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    // You can get an API key at https://pdfshift.io
    apiKey := "sk_xxxxxxxxxxxx"

    params := map[string]interface{}{
        "source": "https://www.example.com",
        "wait_for": "isPageReady"
    }

    // Marshal the parameters into JSON
    jsonParams, err := json.Marshal(params)
    if err != nil {
        fmt.Println("Error marshaling JSON:", err)
        return
    }

    // Create a new HTTP client
    client := &http.Client{}

    // Create a new request
    req, err := http.NewRequest("POST", "https://api.pdfshift.io/v3/convert/pdf", bytes.NewBuffer(jsonParams))
    if err != nil {
        fmt.Println("Error creating request:", err)
        return
    }

    // Set request headers
    req.Header.Set("Content-Type", "application/json")

    // Set basic authentication header
    auth := "api:" + apiKey
    req.Header.Set("Authorization", "Basic "+base64.StdEncoding.EncodeToString([]byte(auth)))

    // Perform the request
    resp, err := client.Do(req)
    if err != nil {
        fmt.Println("Error performing request:", err)
        return
    }
    defer resp.Body.Close()

    // Read response body
    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        fmt.Println("Error reading response body:", err)
        return
    }

    // Check response status code
    if resp.StatusCode >= 400 {
        fmt.Printf("Request failed with status code %d: %s\n", resp.StatusCode, string(body))
        return
    }

    // Save the PDF document
    err = ioutil.WriteFile("result.pdf", body, 0644)
    if err != nil {
        fmt.Println("Error saving PDF document:", err)
        return
    }

    fmt.Println("The PDF document was generated and saved to result.pdf")
}

In case your page doesn't have the javascript function available, but you still need to wait on some elements to be rendered before continuing the conversion, you can add javascript code directly in the request and use it at the same time:

package main

import (
    "bytes"
    "encoding/base64"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    // You can get an API key at https://pdfshift.io
    apiKey := "sk_xxxxxxxxxxxx"

    params := map[string]interface{}{
        "source": "https://www.example.com",
        "javascript": "let isFontReady = false; document.fonts.ready.then(() => isFontReady = true); function isPageReady() { return isFontReady; }",
        "wait_for": "isPageReady"
    }


    // Marshal the parameters into JSON
    jsonParams, err := json.Marshal(params)
    if err != nil {
        fmt.Println("Error marshaling JSON:", err)
        return
    }

    // Create a new HTTP client
    client := &http.Client{}

    // Create a new request
    req, err := http.NewRequest("POST", "https://api.pdfshift.io/v3/convert/pdf", bytes.NewBuffer(jsonParams))
    if err != nil {
        fmt.Println("Error creating request:", err)
        return
    }

    // Set request headers
    req.Header.Set("Content-Type", "application/json")

    // Set basic authentication header
    auth := "api:" + apiKey
    req.Header.Set("Authorization", "Basic "+base64.StdEncoding.EncodeToString([]byte(auth)))

    // Perform the request
    resp, err := client.Do(req)
    if err != nil {
        fmt.Println("Error performing request:", err)
        return
    }
    defer resp.Body.Close()

    // Read response body
    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        fmt.Println("Error reading response body:", err)
        return
    }

    // Check response status code
    if resp.StatusCode >= 400 {
        fmt.Printf("Request failed with status code %d: %s\n", resp.StatusCode, string(body))
        return
    }

    // Save the PDF document
    err = ioutil.WriteFile("result.pdf", body, 0644)
    if err != nil {
        fmt.Println("Error saving PDF document:", err)
        return
    }

    fmt.Println("The PDF document was generated and saved to result.pdf")
}

The above script will wait for all fonts to be ready before returning true for the isPageReady function. PDFShift will then wait for the fonts to be ready, via the isPageReady, before converting the page to PDF.

For further details on the wait_for property and its usage, please refer to our dedicated documentation.

We hope this guide was helpful. If you have any questions or noticed any issues on the code above,
feel free to drop us a line.