Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

actor

package

Go to main page

Versions in this module

v0

v0.35.0

Dec 29, 2025

v0.34.0

Dec 29, 2025

v0.33.0

Dec 28, 2025

v0.32.0

Dec 13, 2025

v0.31.0

Dec 12, 2025

v0.25.0

Dec 10, 2025

v0.22.0

Dec 4, 2025

v0.21.1

Dec 4, 2025

v0.21.0

Dec 2, 2025

v0.20.0

Dec 1, 2025

v0.19.0

Nov 28, 2025

Changes in this version

+ type Actor interface

+ Receive func(ctx *Context, msg Message)

+ type ActorFunc func(ctx *Context, msg Message)

+ func (f ActorFunc) Receive(ctx *Context, msg Message)

+ type AllForOneStrategy struct

+ Decider Decider

+ MaxRestarts int

+ WithinDuration time.Duration

+ func NewAllForOneStrategy(maxRestarts int, within time.Duration, decider Decider) *AllForOneStrategy

+ func (s *AllForOneStrategy) HandleFailure(system *System, child *PID, msg Message, err interface{}) interface{}

+ type ChildSpec struct

+ Factory func() Actor

+ Name string

+ Props *Props

+ type CompositeStrategy struct

+ func NewCompositeStrategy(fallback SupervisorStrategy) *CompositeStrategy

+ func (s *CompositeStrategy) HandleFailure(system *System, child *PID, msg Message, err interface{}) interface{}

+ func (s *CompositeStrategy) RegisterStrategy(errType string, strategy SupervisorStrategy)

+ type Context struct

+ Children []*PID

+ Parent *PID

+ Self *PID

+ Sender *PID

+ func (c *Context) Context() context.Context

+ func (c *Context) Forward(target *PID)

+ func (c *Context) Message() Message

+ func (c *Context) Reply(msg Message)

+ func (c *Context) Spawn(actor Actor, name string) *PID

+ func (c *Context) SpawnWithProps(actor Actor, props *Props) *PID

+ func (c *Context) Stop(pid *PID)

+ func (c *Context) StopSelf()

+ type Decider func(err interface{}) Directive

+ type Directive int

+ const DirectiveEscalate

+ const DirectiveRestart

+ const DirectiveRestartAfter

+ const DirectiveResume

+ const DirectiveStop

+ func DefaultDecider(err interface{}) Directive

+ func EscalatingDecider(err interface{}) Directive

+ func ResumingDecider(err interface{}) Directive

+ func StoppingDecider(err interface{}) Directive

+ func (d Directive) String() string

+ type DirectiveWithDelay struct

+ Delay time.Duration

+ Directive Directive

+ type DispatcherType int

+ const DispatcherDefault

+ const DispatcherShared

+ type ExponentialBackoffStrategy struct

+ Decider Decider

+ InitialDelay time.Duration

+ MaxDelay time.Duration

+ MaxRestarts int

+ func NewExponentialBackoffStrategy(initialDelay, maxDelay time.Duration, maxRestarts int, decider Decider) *ExponentialBackoffStrategy

+ func (s *ExponentialBackoffStrategy) HandleFailure(system *System, child *PID, msg Message, err interface{}) interface{}

+ func (s *ExponentialBackoffStrategy) Reset()

+ type Message interface

+ Kind func() string

+ type OneForOneStrategy struct

+ Decider Decider

+ MaxRestarts int

+ WithinDuration time.Duration

+ func NewOneForOneStrategy(maxRestarts int, within time.Duration, decider Decider) *OneForOneStrategy

+ func (s *OneForOneStrategy) HandleFailure(system *System, child *PID, msg Message, err interface{}) interface{}

+ type PID struct

+ Address string

+ ID string

+ func (p *PID) Request(msg Message, timeout time.Duration) (Message, error)

+ func (p *PID) String() string

+ func (p *PID) Tell(msg Message)

+ type PoisonPill struct

+ func (p *PoisonPill) Kind() string

+ type Props struct

+ Dispatcher DispatcherType

+ MailboxSize int

+ Name string

+ SupervisorStrategy SupervisorStrategy

+ func DefaultProps(name string) *Props

+ type ResponseTimeout struct

+ Target *PID

+ Timeout time.Duration

+ func (r *ResponseTimeout) Error() string

+ func (r *ResponseTimeout) Kind() string

+ type Restarting struct

+ func (r *Restarting) Kind() string

+ type Started struct

+ func (s *Started) Kind() string

+ type Stopped struct

+ func (s *Stopped) Kind() string

+ type Stopping struct

+ func (s *Stopping) Kind() string

+ type SupervisorActor struct

+ func NewSupervisorActor(config *SupervisorConfig) *SupervisorActor

+ func (s *SupervisorActor) GetChild(name string) *PID

+ func (s *SupervisorActor) Receive(ctx *Context, msg Message)

+ type SupervisorConfig struct

+ Children []ChildSpec

+ Strategy SupervisorStrategy

+ type SupervisorStrategy interface

+ HandleFailure func(system *System, child *PID, msg Message, err interface{}) interface{}

+ func DefaultSupervisorStrategy() SupervisorStrategy

+ func LenientSupervisorStrategy() SupervisorStrategy

+ func StrictSupervisorStrategy() SupervisorStrategy

+ type System struct

+ func NewSystem(name string) *System

+ func NewSystemWithConfig(name string, config *SystemConfig) *System

+ func (s *System) GetActor(name string) (*PID, bool)

+ func (s *System) ListActors() []*PID

+ func (s *System) Name() string

+ func (s *System) Request(target *PID, msg Message, timeout time.Duration) (Message, error)

+ func (s *System) Send(target *PID, msg Message)

+ func (s *System) SendWithSender(target *PID, msg Message, sender *PID)

+ func (s *System) Shutdown()

+ func (s *System) ShutdownWithTimeout(timeout time.Duration)

+ func (s *System) Spawn(actor Actor, name string) *PID

+ func (s *System) SpawnWithProps(actor Actor, props *Props) *PID

+ func (s *System) Stats() *SystemStats

+ func (s *System) Stop(pid *PID)

+ func (s *System) StopGracefully(pid *PID, timeout time.Duration) error

+ type SystemConfig struct

+ DeadLetterSize int

+ DefaultActorMailboxSize int

+ EnableDeadLetterLogging bool

+ MailboxSize int

+ PanicHandler func(actor *PID, msg Message, err interface{})

+ func DefaultSystemConfig() *SystemConfig

+ type SystemStats struct

+ AverageLatency time.Duration

+ DeadLetters int64

+ ProcessedMsgs int64

+ StartTime time.Time

+ TotalActors int64

+ TotalMessages int64

+ type Terminated struct

+ Who *PID

+ func (t *Terminated) Kind() string

+ type Unwatch struct

+ Watcher *PID

+ func (u *Unwatch) Kind() string

+ type Watch struct

+ Watcher *PID

+ func (w *Watch) Kind() string