Serialization Methods `var_to_bytes_with_objects` and `bytes_to_var_with_objects` Not Preserving Instance Property Values

[MrZak-dev]

Tested versions

4.3.beta2

System information

MacOS Sonoma, Compatibility Renderer

Issue description

It appears that the methods var_to_bytes_with_objects and bytes_to_var_with_objects do not work as expected when serializing and deserializing class instances. Specifically, properties of the instance revert to their initial values instead of retaining any changes made before serialization.

Steps to reproduce

1. Create an instance of a class.
2. Change a property of the instance.
3. Serialize the instance using var_to_bytes_with_objects.
4. Deserialize the instance using bytes_to_var_with_objects.
5. Observe that the deserialized instance's properties have reverted to their initial values.

Example Code

func _ready():
    var instance = RandomClass.new() # create a custom class that extends `Object`
    instance.thing = "changed"

    var serialized = var_to_bytes_with_objects(instance)

    var deserialized: RandomClass = bytes_to_var_with_objects(serialized)

    assert(deserialized.thing == "changed") # this will fail , and the value is "hello" as the default set in the class property definition

Minimal reproduction project (MRP)

test.zip

[dalexeev]

You should export[^1] the property so that it is taken into account by the duplicate() method and serialization.

This is documented here, but we need to copy the note into descriptions of similar methods, see #80585.

[^1]: At least the PROPERTY_USAGE_STORAGE flag must be present, since 4.3 dev there is an annotation @export_storage.

[MrZak-dev]

@dalexeev adding the @export_storage annotation works as expected , Thank you .. however i just find the documentation confusing a little bit when it says :

Note: Not all properties are included. Only properties that are configured with the @GlobalScope.PROPERTY_USAGE_STORAGE flag set will be serialized.

Then when we take a look at where this link goes :

PropertyUsageFlags PROPERTY_USAGE_STORAGE = 2 The property is serialized and saved in the scene file (default).

The way i interpreted the (default) is that this flag is already set by default for the class' properties. isn't it the case or am i missing something .

[dalexeev]

PROPERTY_USAGE_DEFAULT is used by default for exported properties, in _get_property_list(), etc. But by default, script variables are not exported at all:

var a # SCRIPT_VARIABLE
@export_storage var b # STORAGE | SCRIPT_VARIABLE
@export var c: int # DEFAULT | SCRIPT_VARIABLE

We should probably clarify this in the documentation.

[akien-mga]

Fixed by #94155.