Paquete Context

Plazos, cancelación y valores a nivel de solicitud. Los resultados aparecen en la misma valla: comentarios // en la misma línea cuando son cortos, bloques // multilínea debajo de la muestra cuando no lo son.

WithCancel

Señal de cancelación manual.

ctx, cancel := context.WithCancel(context.Background())
cancel()
ctx.Err()  // context.Canceled

WithTimeout

Cancelación automática después de una duración.

ctx, cancel := context.WithTimeout(context.Background(), time.Millisecond)
defer cancel()
<-ctx.Done()
errors.Is(ctx.Err(), context.DeadlineExceeded)  // true

WithValue

Almacena datos a nivel de solicitud - usa claves tipadas.

type key int
const userKey key = 0
ctx := context.WithValue(context.Background(), userKey, "ada")
ctx.Value(userKey)  // "ada"

Err Canceled

Comprueba por qué terminó el contexto.

ctx, cancel := context.WithCancel(context.Background())
cancel()
errors.Is(ctx.Err(), context.Canceled)  // true

Background TODO

Background es la raíz; TODO es un marcador de posición.

context.Background() != nil  // true

WithDeadline

Cancela en un tiempo absoluto.

ctx, cancel := context.WithDeadline(context.Background(), time.Now().Add(time.Hour))
defer cancel()
ctx.Err() == nil  // true hasta la fecha límite

Select Done

Espera la cancelación o el trabajo.

ctx, cancel := context.WithCancel(context.Background())
cancel()
select {
case <-ctx.Done():
    errors.Is(ctx.Err(), context.Canceled)  // true
}

Pasar Context Primero

Por convención, Context es el primer parámetro.

// func Load(ctx context.Context, id string) error

No Almacenar Ctx

No almacenes Context dentro de structs de larga duración - pásalo como parámetro.

// prefer func (s *Svc) Get(ctx context.Context, id string)

Context de Solicitud HTTP

Deriva de la solicitud.

// ctx := r.Context()

Cause Go 1.20

WithCancelCause para razones de cancelación más ricas.

// ctx, cancel := context.WithCancelCause(parent)
// cancel(fmt.Errorf("reason"))

Ignorar Riesgo del Padre

Usar Background en medio de la pila pierde la cancelación - pasa el ctx padre.

// incorrecto: context.Background() dentro de helpers de biblioteca

Timeout Anidado

Los timeouts hijos deben ser más cortos que el padre cuando están anidados.

// padre 5s, hijo WithTimeout(padre, time.Second)

AfterFunc

Ejecuta una función después de la cancelación (Go 1.21+).

// stop := context.AfterFunc(ctx, func() { ... })

Tipo de Clave de Valor

Los tipos de clave privados evitan colisiones.

type ctxKey struct{}
ctx := context.WithValue(context.Background(), ctxKey{}, 1)
ctx.Value(ctxKey{})  // 1

Relacionado

• Goroutines de Concurrencia - cancelar trabajadores
• Conceptos Esenciales de Net HTTP - r.Context()
• Manejo de Errores - context.Canceled

Enlaces Externos Relacionados

• pkg.go.dev - Sitio oficial de documentación y descubrimiento de paquetes.
• Documentación de la Biblioteca Estándar de Go - Referencia completa de la biblioteca estándar.
• Blog de Go (Oficial) - Anuncios oficiales, análisis profundos y notas de lanzamiento.
• Concurrencia en Go (O'Reilly) - Mismo libro en O'Reilly.
• El Lenguaje de Programación Go (ebook) - Donovan & Kernighan.

Versiones de Stack: Go 1.26.x · chi/gin/echo latest (verificar en la compilación)