Destroying

Unsafe

For thread safety, this property is not safe to read in an unsynchronized thread.

Event of:

Description:

The Destroying event fires immediately before the Instance or one of its ancestors is destroyed.

The Instance will never be deleted from memory while a connected function is still using it. However, if the function yields at any point, the Instance and its descendants will be parented to nil.

Code Samples

Using the Destroying Event

This sample demonstrates how an Instance being destroyed remains in place until the connected function yields.

			
				Using the Destroying Event
			
				Expected Output
			
				Expand
				
			local part = Instance.new("Part", workspace)

local function onPartDestroying()
	print("Before yielding:", part:GetFullName(), #part:GetChildren())
	task.wait()
	print("After yielding:", part:GetFullName(), #part:GetChildren())
end

part.Destroying:Connect(onPartDestroying)

part:Destroy()
		
			Before yielding: Workspace.Part 1
After yielding: Part 0
		
				Copy Code
			
				Light Theme