Context | Golang basics

Mahdi.Kh

September 21, 2026

We get familiar with context in Go and learn how to use it.

The context package is part of Go's standard library and provides the Context interface. Using this interface, you can define and manage a deadline, a timeout, and a cancellation signal for various operations.

Beyond that, context makes it possible to hold and pass along data whose scope and lifetime are limited to a specific request. This feature is especially useful in web applications and distributed services; for example, you can pass information such as an authenticated user's ID, a request ID, or transaction-related data between the different layers of an application through the context.

The Context interface has a simple structure, like this:

type Context interface {
    Deadline() (deadline time.Time, ok bool) // When’s it gotta stop?
    Done() <-chan struct{}                   // Signals “we’re done”
    Err() error                              // Why’d it stop?
    Value(key any) any                       // Pass some goodies
}

To create a Context, you can use the functions below:

context.Background: creates an initial, empty Context. It's usually used as a starting point, and you can then add a deadline and cancellation to it.
context.TODO: if we need an empty context but don't yet know what we're going to do with the Context, we can use this function.
context.WithCancel: this function can be used for cancellation, and generally for creating a cancellation signal.
context.WithTimeout / context.WithDeadline: these functions can be used to create a timeout signal or a deadline signal, respectively.
context.WithValue: using this function, you can put a value into the context and later retrieve it from the context using the Value function.

Canceling With `context`

Using context, you can send a cancellation signal to goroutines so they stop their execution when needed. This feature is very useful for managing long-running operations, freeing up resources, and avoiding unnecessary processing.

In the example below, we first create an initial Context using context.Background(). Then, using context.WithCancel(), we get a cancelable Context and a cancel function. Using time.AfterFunc, the cancel function is called after one second, which cancels the Context, and the goroutines depending on it stop after receiving the signal from ctx.Done().

#go #golang

Latest

Most viewed

Latest

Most viewed

Comments