ErrorContext class
ErrorContext — debugging metadata captured at the throw site.
Sources pre-IDL:
C ABI rac_structured_error.h:102 rac_error_t fields source_file,
source_line, source_function plus a
rac_stack_frame_t32 fixed-size
stack capture and 3 custom k/v slots
(custom_key1..3 / custom_value1..3).
The fixed-shape custom slots flatten
to a metadata map<string,string> in
proto.
Swift ErrorContext.swift (matches Dart equivalent).
Kotlin SDKError.kt No ErrorContext — uses Throwable.cause
only. Will pick up source location
from this proto on regeneration.
Dart error_context.dart:4 StackTrace? stackTrace, String file,
int line, String function, DateTime
timestamp, String threadInfo.
RN ErrorContext.ts:11 stackTrace[], file, line, function,
timestamp, threadInfo.
Web ErrorTypes.ts (no context type).
Stack traces are intentionally NOT modeled here — they are platform-shaped
(string lines on RN/Dart, rac_stack_frame_t[] on C, StackTrace on Dart) and
belong in a platform-local logging path, not in the wire IDL. If the C ABI
ever ships symbolicated frames, add a repeated StackFrame frames field
guarded by a feature flag.
- Available extensions
Constructors
-
ErrorContext({Iterable<
MapEntry< ? metadata, String? sourceFile, int? sourceLine, String? operation, String? fieldPath})String, String> > -
factory
-
ErrorContext.fromBuffer(List<
int> data, [ExtensionRegistry registry = $pb.ExtensionRegistry.EMPTY]) -
factory
- ErrorContext.fromJson(String json, [ExtensionRegistry registry = $pb.ExtensionRegistry.EMPTY])
-
factory
Properties
- fieldPath ↔ String
-
The structured field path a validation error refers to
("
getter/setter pair
- hashCode → int
-
Calculates a hash code based on the contents of the protobuf.
no setterinherited
- info_ → BuilderInfo
-
no setter
- isFrozen → bool
-
Returns
trueif this message is marked read-only. Otherwisefalse.no setterinherited -
metadata
→ PbMap<
String, String> -
Free-form key/value pairs for telemetry tagging. Maps onto the C ABI's
three custom_key/custom_value slots and Dart's
Map<String, dynamic>(after string-coercion).no setter - operation ↔ String
-
Logical operation name ("loadModel", "generate", "transcribeStream",
...). Lets clients route on operation without parsing free-text.
Maps roughly onto Dart's
functionfield and C ABI's source_function; we use the more generic "operation" name because some platforms (C++, Swift) symbolicate the function name from the stack frame instead.getter/setter pair - runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- sourceFile ↔ String
-
FILE at the throw site. C ABI cap is RAC_MAX_METADATA_STRING (256).
getter/setter pair
- sourceLine ↔ int
-
LINE at the throw site.
getter/setter pair
- unknownFields → UnknownFieldSet
-
no setterinherited
Methods
-
addExtension(
Extension extension, Object? value) → void -
Adds an extension field value to a repeated field.
inherited
-
check(
) → void -
Throws a StateError if the message has required fields without a value.
inherited
-
clear(
) → void -
Clears all data that was set in this message.
inherited
-
clearExtension(
Extension extension) → void -
Clears an extension field and also removes the extension.
inherited
-
clearField(
int tagNumber) → void -
Clears the contents of a given field.
inherited
-
clearFieldPath(
) → void -
clearOperation(
) → void -
clearSourceFile(
) → void -
clearSourceLine(
) → void -
clone(
) → ErrorContext - Creates a deep copy of the fields in this message.
-
copyWith(
void updates(ErrorContext)) → ErrorContext -
Apply
updatesto a copy of this message. -
createEmptyInstance(
) → ErrorContext - Creates an empty instance of the same message type as this.
-
deepCopy(
) → T -
Available on T, provided by the GeneratedMessageGenericExtensions extension
Returns a writable deep copy of this message. -
extensionsAreInitialized(
) → bool -
inherited
-
freeze(
) → GeneratedMessage -
Make this message read-only.
inherited
-
getDefaultForField(
int tagNumber) → dynamic -
Returns the default value for the given field.
inherited
-
getExtension(
Extension extension) → dynamic -
Returns the value of
extension.inherited -
getField(
int tagNumber) → dynamic -
Returns the value of the field associated with
tagNumber, or the default value if it is not set.inherited -
getFieldOrNull(
int tagNumber) → dynamic -
Returns the value of a field, ignoring any defaults.
inherited
-
getTagNumber(
String fieldName) → int? -
inherited
-
hasExtension(
Extension extension) → bool -
Returns
trueif a value ofextensionis present.inherited -
hasField(
int tagNumber) → bool -
Whether this message has a field associated with
tagNumber.inherited -
hasFieldPath(
) → bool -
hasOperation(
) → bool -
hasRequiredFields(
) → bool -
Whether the message has required fields.
inherited
-
hasSourceFile(
) → bool -
hasSourceLine(
) → bool -
isInitialized(
) → bool -
Whether all required fields in the message and embedded messages are set.
inherited
-
mergeFromBuffer(
List< int> input, [ExtensionRegistry extensionRegistry = ExtensionRegistry.EMPTY]) → void -
Merges serialized protocol buffer data into this message.
inherited
-
mergeFromCodedBufferReader(
CodedBufferReader input, [ExtensionRegistry extensionRegistry = ExtensionRegistry.EMPTY]) → void -
Same as
mergeFromBuffer, but takes aCodedBufferReaderinput.inherited -
mergeFromJson(
String data, [ExtensionRegistry extensionRegistry = ExtensionRegistry.EMPTY]) → void -
Merges field values from
data, a JSON object, encoded as described byGeneratedMessage.writeToJson.inherited -
mergeFromJsonMap(
Map< String, dynamic> json, [ExtensionRegistry extensionRegistry = ExtensionRegistry.EMPTY]) → void -
Merges field values from a JSON object represented as a Dart map.
inherited
-
mergeFromMessage(
GeneratedMessage other) → void -
Merges the contents of the
otherinto this message.inherited -
mergeFromProto3Json(
Object? json, {TypeRegistry typeRegistry = const TypeRegistry.empty(), bool ignoreUnknownFields = false, bool supportNamesWithUnderscores = true, bool permissiveEnums = false}) → void -
Merges field values from
json, a JSON object using proto3 encoding.inherited -
mergeUnknownFields(
UnknownFieldSet unknownFieldSet) → void -
inherited
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
rebuild(
void updates(T)) → T -
Available on T, provided by the GeneratedMessageGenericExtensions extension
Applyupdatesto a copy of this message. -
setExtension(
Extension extension, Object value) → void -
Sets the value of a non-repeated extension field to
value.inherited -
setField(
int tagNumber, Object value) → void -
Sets the value of a field by its
tagNumber.inherited -
toBuilder(
) → GeneratedMessage -
Creates a writable, shallow copy of this message.
inherited
-
toDebugString(
) → String -
Returns a String representation of this message.
inherited
-
toProto3Json(
{TypeRegistry typeRegistry = const TypeRegistry.empty()}) → Object? -
Returns an Object representing Proto3 JSON serialization of
this.inherited -
toString(
) → String -
Returns a String representation of this message.
inherited
-
writeToBuffer(
) → Uint8List -
Serialize the message as the protobuf binary format.
inherited
-
writeToCodedBufferWriter(
CodedBufferWriter output) → void -
Same as
writeToBuffer, but serializes to the givenCodedBufferWriter.inherited -
writeToJson(
) → String -
Returns a JSON string that encodes this message.
inherited
-
writeToJsonMap(
) → Map< String, dynamic> -
Returns the JSON encoding of this message as a Dart Map.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited
Static Methods
-
create(
) → ErrorContext -
getDefault(
) → ErrorContext