OS.move_to_trash() not functioning or poorly documented

[NationalityNZ]

Godot version

4.0 Alpha 9

System information

Windows 10

Issue description

Using OS.move_to_trash always produces a generic failure (error code 1). This could be due to my windows configuration, or it could also be due to a bug, or it could be because OS.move_to_trash() is very minimally documented.

Steps to reproduce

Run the project and click the button.

func _on_button_pressed():
	var result = OS.move_to_trash("res://test.txt")
	print(result)

Minimal reproduction project

Move_To_TrashProject.zip

[Calinou]

Can you reproduce this on 3.4.4 3.5rc3?

Did you disable the system trash in your Windows settings, or did you set a file size limit on it?

[NationalityNZ]

I can manually send files to the recycling bin, which I suppose means it is not disabled and not file size limited. My recycling bin is on a different hard drive from my godot projects if that makes a difference.

[Calinou]

My recycling bin is on a different hard drive from my godot projects if that makes a difference.

This could be the cause of the issue. Can you reproduce this issue on a project created on the same hard drive?

Also, is your recycle bin on the C: drive or another drive?

[NationalityNZ]

My recycle bin is in the default location C:
Also, 3.4.4 apparently doesn't have OS.move_to_trash()
I will test whether putting it on the same directory helps.

[NationalityNZ]

I put a test project on the same drive as the recycling bin and unfortunately it didn't work. This was a new project.

[Calinou]

Also, 3.4.4 apparently doesn't have OS.move_to_trash()

It's only exposed to scripting since 3.5rc3: #60542

[bruvzg]

move_to_trash do not globalize path, therefore require a full real path (like c:/something/). Since res:// in the exported project point to the contents of read only PCK, move_to_trash on res://something is not valid use anyway. But probably it should be considered a bug since it should be usable on user:// files.

Edit: removed Windows label, it seems to be the same on macOS and Linux.