Struct Decl

compiler/decls.go:30–82

Decl represents a package-level symbol (e.g. a function, variable or type). It contains code generated by the compiler for this specific symbol, which is grouped by the execution stage it belongs to in the JavaScript runtime. When adding new fields to this struct, make sure the field is exported s

// When adding new fields to this struct, make sure the field is exported
// so that it Gob serializes correctly for the archive cache.
type Decl struct {
	// The package- or receiver-type-qualified name of function or method obj.
	// See go/types.Func.FullName().
	FullName string
	// A logical equivalent of a symbol name in an object file in the traditional
	// Go compiler/linker toolchain. Used by GopherJS to support go:linkname
	// directives. Must be set for decls that are supported by go:linkname
	// implementation.
	LinkingName symbol.Name
	// A list of package-level JavaScript variable names this symbol needs to declare.
	Vars []string
	// A JS expression by which the object represented by this decl may be
	// referenced within the package context. Empty if the decl represents no such
	// object.
	RefExpr string
	// NamedRecvType is method named recv declare.
	NamedRecvType string
	// JavaScript code that declares a local variable for an imported package.
	ImportCode []byte
	// JavaScript code that declares basic information about a named type symbol.
	// It configures basic information about the type and its identity.
	TypeDeclCode []byte
	// JavaScript code that assigns exposed named types to the package.
	ExportTypeCode []byte
	// JavaScript code that declares basic information about an anonymous type.
	// It configures basic information about the type.
	// This is added to the finish setup phase to have access to all packages.
	AnonTypeDeclCode []byte
	// JavaScript code that declares basic information about a function or
	// method symbol. This contains the function's or method's compiled body.
	// This is added to the finish setup phase to have access to all packages.
	FuncDeclCode []byte
	// JavaScript code that assigns exposed functions to the package.
	// This is added to the finish setup phase to have access to all packages.
	ExportFuncCode []byte
	// JavaScript code that initializes reflection metadata about a type's method list.
	// This is added to the finish setup phase to have access to all packages.
	MethodListCode []byte
	// JavaScript code that initializes the rest of reflection metadata about a type
	// (e.g. struct fields, array type sizes, element types, etc.).
	// This is added to the finish setup phase to have access to all packages.
	TypeInitCode []byte
	// JavaScript code that needs to be executed during the package init phase to
	// set the symbol up (e.g. initialize package-level variable value).
	InitCode []byte
	// DCEInfo stores the information for dead-code elimination.
	DCEInfo dce.Info
	// Set to true if a function performs a blocking operation (I/O or
	// synchronization). The compiler will have to generate function code such
	// that it can be resumed after a blocking operation completes without
	// blocking the main thread in the meantime.
	Blocking bool
}

// minify returns a copy of Decl with unnecessary whitespace removed from the
// JS code.