De handle verwijst zwak naar de instantie en verlengt niet zijn levensduur.

```lua
local target = Instance.new("Part")
target.Name = "TargetPart"

local handle = InstanceHandle.new(target)
local empty = InstanceHandle.new(nil)

print(handle:Get()) --> TargetPart
print(empty:Get()) --> nil
```
Gooi een fout als `instance` noch een `Class.Instance` noch `nil` is.


InstanceHandle.new

instance

De instantie waarnaar verwezen moet worden, of `nil` voor een lege handle.


Geeft een nieuwe `Datatype.InstanceHandle` terug die verwijst naar de gegeven
`Class.Instance`.


Het `Datatype.InstanceHandle` datatype is een zwakke referentie naar een
`Class.Instance` die mogelijk niet lokaal beschikbaar is. Gebruik het om te wijzen naar een
instantie die nog niet is aangekomen, kan streamen, of alleen op een andere
machine bestaat, en om die instantie op te halen zodra deze er is.

Een handle verwijst altijd naar hetzelfde doel. Om dat doel te bereiken, roep
`Datatype.InstanceHandle:Wait()` aan, wat wacht totdat de instantie
beschikbaar is:

```lua
local Workspace = game:GetService("Workspace")

local part = Instance.new("Part")
local target = Instance.new("Part")
target.Name = "TargetPart"
part.Parent = Workspace
target.Parent = Workspace

part:SetAttribute("Target", target)

local handle = part:GetAttribute("Target")
local instance = handle:Wait(10)
if instance then
	print("Doel is", instance.Name) --> Doel is TargetPart
end
```
Geef de voorkeur aan `Datatype.InstanceHandle:Wait()` met een time-out zodat je code draait zodra de instantie verschijnt. Gebruik `Datatype.InstanceHandle:Get()` wanneer je een onmiddellijke antwoord wilt en `nil` kunt verwerken, zoals in code die elke
frame draait.

#### Voorbeelden

##### Attributen

Attributen gebruiken `Datatype.InstanceHandle` in plaats van een gewone instantie
referentie. Aangezien de handle zelf nooit `nil` is, kun je een
attribuut dat ontbreekt onderscheiden van een waarvan de instantie momenteel
niet aanwezig is:

```lua
local part = Instance.new("Part")

print(part:GetAttribute("Target")) --> nil

part:SetAttribute("Target", InstanceHandle.new(nil))
local handle = part:GetAttribute("Target")
print(handle:Get()) --> nil
```

`Datatype.InstanceHandle` attributen verschijnen ook in
`Class.Instance:GetAttributes()`, die geen `nil` waarden kan bevatten.

`Class.Instance:GetAttributeChangedSignal()` wordt geactiveerd wanneer het attribuut
wordt ingesteld op een nieuw doel of wordt verwijderd. Het wordt niet geactiveerd wanneer het doel binnenkomt of
uitgaat, of wanneer het doel wordt vernietigd. Om te reageren op beschikbaarheid, combineer het
signaal met `Datatype.InstanceHandle:Wait()`:

```lua
local part = Instance.new("Part")

part:GetAttributeChangedSignal("Target"):Connect(function()
	local handle = part:GetAttribute("Target")
	if not handle then
		return
	end

	local instance = handle:Wait(10)
	if instance then
		print("Nieuw doel:", instance.Name)
	end
end)
```

##### Remote events

Geef een handle door via een `Class.RemoteEvent` om de ontvanger een referentie
te geven naar een instantie die hij nog niet heeft. De ontvanger wacht op de instantie
in plaats van niets te krijgen.

In een server script, roep deze functie aan met je remote event, de ontvangende
speler, en het model om te verzenden:

```lua
local function sendHandle(remoteEvent: RemoteEvent, player: Player, spawnedModel: Model)
	local handle = InstanceHandle.new(spawnedModel)
	remoteEvent:FireClient(player, handle)
end
```
In een client script, roep deze functie aan met hetzelfde remote event om te beginnen
luisteren voordat de server de handle verzendt:

```lua
local function receiveHandles(remoteEvent: RemoteEvent)
	remoteEvent.OnClientEvent:Connect(function(handle)
		local model = handle:Wait(10)
		if model then
			print("Ontvangen", model.Name)
		end
	end)
end
```

#### Eigendom

Een handle fungeert als een zwakke referentie. Het houdt zijn doel nooit in leven. De
levensduur van het doel wordt gecontroleerd door de rest van je ervaring: zijn
ouder en alle gewone referenties die je scripts vasthouden die voorkomen dat het
wordt opgeruimd.

`Datatype.InstanceHandle:Get()` en `Datatype.InstanceHandle:Wait()` retourneren een
gewone instantie referentie, die de instantie in leven houdt zolang je deze vasthoudt.

Een handle is verder lichtgewicht en heeft geen opruiming nodig.

#### Gelijkheid

Twee handles zijn gelijk wanneer ze naar hetzelfde doel verwijzen, zelfs als je ze
afzonderlijk hebt gemaakt en zelfs nadat het doel verdwenen is. Alle lege handles zijn gelijk
aan elkaar. Elke handle is nog steeds een unieke waarde.

```lua
local instance1 = Instance.new("Part")
local instance2 = Instance.new("Part")

local a = InstanceHandle.new(instance1)
local b = InstanceHandle.new(instance1)
local c = InstanceHandle.new(instance2)

print(a == b) --> true
print(a == c) --> false
```
Gelijkheid hangt af van de identiteit van het doel, dus het werkt nog steeds wanneer het doel momenteel
niet beschikbaar is.


Deze methode yieldt niet.

`Get()` retourneert `nil` wanneer de handle leeg is, wanneer het doel niet
is aangekomen op de client of server die het script uitvoert, wanneer het doel niet
meer beschikbaar is na streaming, wanneer het doel is opgeruimd, en wanneer het doel niet toegankelijk is voor het aanroepende script. Gebruik
`Datatype.InstanceHandle:Wait()` om te yielden totdat het doel aankomt in plaats van
één keer te controleren.


InstanceHandle:Get

De verwezen instantie, of `nil` als deze niet lokaal beschikbaar is.


Geeft de verwezen `Class.Instance` terug als deze lokaal beschikbaar is,
anders `nil`.


Geeft `nil` terug als de handle leeg is, het doel niet toegankelijk is voor het
aanroepende script, of als de `timeout` eerst verstrijkt. `Wait()` retourneert onmiddellijk
wanneer het doel al beschikbaar is en wanneer de handle leeg is.

Geef een time-out door wanneer je niet kunt garanderen dat het doel de
aanroeper bereikt. Een doel dat wordt vernietigd voordat het repliceert, laat een handle
achter die nooit oplost, en een `Wait()` zonder time-out retourneert nooit. Een
hangende wacht kan niet worden geannuleerd: `Library.task.cancel()` stopt je
coroutine, maar de wacht wordt niet afgemeld totdat het doel aankomt of de
time-out verstrijkt.

`timeout` moet een getal groter dan nul zijn. Gooi een fout als `timeout` nul,
negatief, of geen getal is.


InstanceHandle:Wait

timeout

Hoe lang te wachten, in seconden. Moet groter zijn dan nul. Wacht
oneindig wanneer weggelaten.


De verwezen instantie, of `nil` als de handle leeg is, het doel
niet toegankelijk is voor het aanroepende script, of als de `timeout` eerst verstrijkt.


Yieldt totdat de verwezen `Class.Instance` lokaal beschikbaar is, en geeft deze
terug.


InstanceHandle

Een lichte, zwakke referentie naar een `Class.Instance` die mogelijk niet lokaal beschikbaar is.


/reference/engine/datatypes/InstanceHandle.yaml

Data Type

Instance

Een object dat verbonden functies uitvoert bij een specifieke gebeurtenis.

RBXScriptSignal

Luau

number

Ervaringen

Avatar

Assets

Voorbeelden en projecten

Engine-API

Open Cloud-API

Studio

Analytics

Platform

Tutorials

Makerprogramma's

Onderwijs

Meer informatie

Deze methode is asynchroon en retourneert een 'Bewerking', die de huidige status van de bewerking weergeeft. Deze bevat een eindpuntpad dat je kunt opvragen om het daadwerkelijke antwoord en de bijbehorende metadata te verkrijgen. Zie de [documentatie]({longRunningOperationsLink}) over langlopende bewerkingen voor meer informatie. 

De volgende secties beschrijven de antwoord- en metadata-objecten die worden verstrekt wanneer een bewerking is voltooid.

Bèta-eindpunten zijn klaar voor openbaar gebruik. Ingrijpende wijzigingen zijn mogelijk, maar komen zelden voor.

Deze Open Cloud-documentatiepagina's worden op 31 maart 2026 verwijderd. Op dat moment word je automatisch doorgestuurd naar de nieuwe Open Cloud-documentatie. {linkStart}Meer informatie{linkEnd}

Deze oude Open Cloud-pagina's worden op 31 maart 2026 verwijderd en doorgestuurd. {linkStart}Meer informatie{linkEnd}

Experimentele eindpunten zijn klaar voor openbaar gebruik, maar kunnen af en toe ingrijpende wijzigingen ondergaan naarmate het API-contract wordt afgerond.

Dit eindpunt kan in de ervaring worden aangeroepen via {httpServiceLinkStart}HttpService{httpServiceLinkEnd} met een API-sleutel.

Dit veld kan worden ingesteld bij het maken van een bron, maar mag niet worden gewijzigd door latere verzoeken.

Deze velden kunnen worden ingesteld bij het maken van een bron, maar mogen niet worden gewijzigd door latere verzoeken.

Dit veld kan worden verstrekt in verzoeken, maar wordt nooit opgenomen in antwoorden.

Verouderde verificatiemethode. Geef altijd de voorkeur aan het gebruik van een API-sleutel of OAuth 2.0 wanneer beschikbaar.

Per API-sleutel: {maxInPeriod} verzoeken elke {periodInSeconds} seconden per IP-adres

Vereist geen verificatie om aan te roepen. Heeft doorgaans aanzienlijk lagere snelheidslimieten. Geef altijd de voorkeur aan het gebruik van een API-sleutel of OAuth 2.0 wanneer beschikbaar.

Voor elke groepering hoeft slechts één van de volgende velden in het schema te worden opgegeven, de overige kunnen worden uitgesloten.

Je kunt je op elk moment weer aanmelden. {linkStart}Geef feedback.{linkEnd}

Je bekijkt de oude documenten. {linkStart}Geef feedback.{linkEnd}

Je kunt je op elk moment afmelden. Dan word je teruggestuurd naar de oude referentiepagina's. {linkStart}Geef feedback.{linkEnd}

Je bekijkt de vernieuwde documenten. {linkStart}Geef feedback.{linkEnd}

Dit veld kan worden ingesteld voor antwoorden, maar wordt genegeerd in verzoeken.

Opmerking: snelheidslimieten kunnen lager zijn tijdens perioden met veel verkeer. Bepaalde eindpunten hebben aanvullende snelheidslimieten. [Meer informatie over snelheidslimieten]({link}).

{limit} verzoeken per dag voor alle API-sleutels van een gebruiker of groep

{limit} verzoeken per uur voor alle API-sleutels van een gebruiker of groep

{limit} verzoeken per minuut voor alle API-sleutels van een gebruiker of groep

{limit} verzoeken per seconde voor alle API-sleutels van een gebruiker of groep

{limit} verzoeken per minuut per eigenaar van API-sleutel

{limit} verzoeken per dag per app-gebruiker

{limit} verzoeken per uur per app-gebruiker

{limit} verzoeken per minuut per app-gebruiker

{limit} verzoeken per seconde per app-gebruiker

{limit} verzoek(en) per seconde per eigenaar van API-sleutel

Het bereik bepaalt welke toestemmingen je inloggegevens hebben. Je inloggegevens hebben alleen toegang tot de eindpunten die worden ondersteund door het bereik dat je hebt geselecteerd.

Stabiele eindpunten zijn productieklaar en zullen tijdens hun levensduur bijna nooit ingrijpende wijzigingen ondergaan.

Met dit doel kun je de toegang van je sleutel beperken tot geselecteerde {requiredParts}

Met dit doel kun je de toegang van je sleutel beperken tot geselecteerde {requiredParts} en {optionalParts}

Doeltypen worden gebruikt om de bronnen te beperken waarvoor je inloggegevens toegang hebben. Alleen de geselecteerde bronnen kunnen worden gebruikt, zelfs als je account toegang heeft tot aanvullende bronnen. Het is mogelijk dat een bepaald bereik geen doelonderdelen heeft. In deze gevallen kunnen al je relevante bronnen worden gebruikt. 

Het universele onderdeel op het hoogste niveau hoeft niet te worden geselecteerd voor API-sleutels die eigendom zijn van de gebruiker. In dit geval heeft je API-sleutel toegang tot al je ervaringen die eigendom zijn van gebruikers en ervaringen die eigendom zijn van groepen waarvoor je de juiste groepsrechten hebt.

'Probeer het uit' wordt nog niet ondersteund voor eindpunten waarvoor een API-sleutel of OAuth 2.0-verificatie vereist is

Cookie-authenticatie is uitgeschakeld voor bewerkingen met een hoog risico om veiligheidsredenen.

Eindpunten met kritiek risico zijn uiterst gevoelig en 'Probeer het uit' is uitgeschakeld om veiligheidsredenen

Opmerking: authenticatieheaders zijn niet opgenomen in dit codevoorbeeld. Mogelijk moet je een authenticatieheader toevoegen om deze opdracht te kunnen uitvoeren.

Dit is een eindpunt met een hoog risico dat kritieke gegevens kan wijzigen of verwijderen. Wees uiterst voorzichtig bij het testen.

Dit API-eindpunt is geclassificeerd als HOOG RISICO en kan van invloed zijn op live gegevens of gebruikersaccounts.

Geverifieerde verzoeken aan API's met een hoog risico kunnen wijzigingen aanbrengen die niet ongedaan kunnen worden gemaakt. Controleer de parameters van je verzoek zorgvuldig voordat je verder gaat.

Dit is een eindpunt met een laag risico dat gegevens ophaalt. Dit is over het algemeen veilig om te testen.

Dit is een eindpunt met een gemiddeld risico dat gegevens wijzigt. Test voorzichtig met niet-kritieke accounts, aangezien wijzigingen permanent kunnen zijn.

Plak hier nooit tekst uit andere bronnen en stuur nooit informatie van deze pagina naar anderen om je account veilig te houden.

Je staat op het punt live API-eindpunten te testen met de daadwerkelijke inloggegevens van je account.

Ga alleen verder als je de implicaties begrijpt van de API-oproepen die je wilt uitvoeren. Lees de API-documentatie zorgvuldig door voordat je gaat testen.

API-oproepen worden gedaan met behulp van je geverifieerde sessie

Dit zijn echte API-oproepen die van invloed kunnen zijn op je account of gegevens

Snelheidslimieten en andere API-beperkingen zijn van toepassing

Sommige bewerkingen kunnen gegevens wijzigen of verwijderen

Dit eindpunt is vervangen door deze aanbevolen alternatieve eindpunten:

Het volgend bereik is vereist om dit eindpunt aan te roepen. Raadpleeg [API-sleutels beheren]({apiKeyReferenceDocLink}) voor meer 
informatie over het genereren van de juiste sleutels.

Raadpleeg [API-sleutels beheren]({apiKeyReferenceDocLink}) voor meer informatie over het genereren van sleutels.

De volgende eindpunten zijn beschikbaar op paden ten opzichte van de basis-URL.

Deze string is opgemaakt als een [FieldMask](/cloud/reference/types#fieldmask).

Een JSON-waarde kan 'null', 'boolean', 'string', 'number', 'array' of 'object' zijn.

Het volgende bereik is vereist om je OAuth 2.0-applicatie dit eindpunt te laten gebruiken. Raadpleeg [App-registratie en -beoordeling]({oauth2ReferenceDocLink}) voor meer informatie over het registreren van een OAuth 2.0-applicatie.

Raadpleeg [App-registratie en -beoordeling]({oauth2ReferenceDocLink}) voor meer informatie over het registreren van een OAuth 2.0-applicatie.

De volgende objecten beschrijven payloads die worden geaccepteerd of geretourneerd. Raadpleeg elk afzonderlijk eindpunt voor meer informatie over wanneer deze objecten worden gebruikt.

Het volgende bereik is vereist om dit eindpunt aan te roepen.

Bronpaden

Deze string is opgemaakt als een [Tijdstempel](/cloud/reference/types#timestamp).

Niet aanbevolen

Je bekijkt de vernieuwde Open Cloud-referentie.

Je hebt je afgemeld voor de nieuwe Open Cloud-referentie.

Bekijk je factureringsaccounts voor advertenties.

Verleent toegang om factureringsaccounts te configureren en advertentietegoed te kopen.

Bekijk je advertentiecampagnes en hun prestaties.

Je advertentiecampagnes maken, bijwerken en beheren.

Hiermee kun je informatie over je assets bekijken.

Hiermee kun je assets uploaden naar en bijwerken op Roblox.

Hiermee kun je assetmachtigingen verlenen aan alle onderwerpen (inclusief groepen en ervaringen) en assets waartoe je account toegang heeft.

Hiermee kun je assettoestemmingen verlenen aan alle onderwerpen (inclusief groepen en ervaringen) en assets waartoe je account toegang heeft.

Hiermee kun je namens jou de status en resultaten van taken voor automatische instelling van avatars bekijken.

Hiermee kun je namens jou taken voor automatische instelling van avatars maken en beheren.

Geeft de mogelijkheid om badges van de gebruiker bij te werken.

Hiermee kun je informatie over je commerciële items bekijken.

Hiermee kun je wijzigingen aanbrengen in je gesynchroniseerde commerciële items.

Hiermee kun je informatie over je Connecties met handelaren bekijken.

Hiermee kun je je connecties met handelaren bewerken.

Hiermee kun je informatie over je Creatorwinkel-producten bekijken.

Hiermee kun je informatie over opgeslagen items in je Creatorwinkel bekijken.

Hiermee kun je informatie over opgeslagen items in je Creatorwinkel wijzigen.

Geeft toegang om namens jou gegevensopslagplaatsen te maken.

Geeft toegang om namens jou gegevensopslagplaatsen te verwijderen.

Geeft toegang om een lijst met gegevensopslagplaatsen te lezen.

Geeft toegang om een snapshot van je gegevensopslagplaatsen te maken.

Geeft toegang om items in je gegevensopslagplaatsen te maken.

Geeft toegang om specifieke items te markeren voor verwijdering.

Geeft toegang om de items van je gegevensopslag te vermelden.

Geeft toegang om specifieke items in je gegevensopslagplaatsen te lezen.

Geeft toegang om de waarde, attributen en gebruikers van een item bij te werken.

Geeft toegang om revisies van de items van je gegevensopslag te verwijderen.

Geeft toegang om revisies van de items van je gegevensopslag te vermelden.

Geeft toegang om gelezen revisies van de items van je gegevensopslag te vermelden.

Geeft toegang om de configuratiegegevens van de ontwikkelaarsproducten van de geautoriseerde gebruiker te bekijken.

Geeft toegang om de Developer Products van de geautoriseerde gebruiker te bewerken.

Hiermee kun je informatie over de omgevingen van je universum bekijken.

Hiermee kun je de omgevingen van je universum bewerken.

Geeft toegang om de configuratiegegevens van de game passes van de geautoriseerde gebruiker te bekijken.

Geeft toegang om de game passes van de geautoriseerde gebruiker te bewerken.

Geeft toegang om informatie over de communityforums voor je account te bekijken.

Geeft toegang om informatie over de communityforums voor je account te beheren.

Hiermee kun je informatie over je community's bekijken.

Hiermee kun je lidmaatschapsverzoeken voor de community en rolwijzigingen van lager gerangschikte communityleden beheren voor je account.

Hiermee kun je de eigenschapsgegevens van een instantie bekijken.

Hiermee kun je de property-gegevens van instanties wijzigen (momenteel alleen ondersteuning voor scripts).

Hiermee kun je informatie over je inventaris bekijken.

Geeft toegang om gebruikersassets te beheren.

Geeft toegang om je badges te beheren en Robux uit te geven.

Geeft toegang om de badges van de geautoriseerde gebruiker bij te werken.

Geeft toegang om je ontwikkelaarsproducten te beheren.

Geeft toegang om informatie te lezen over de ervaringen waarvoor je meldingen hebt ingeschakeld.

Geeft toegang om namens jou meldingen voor ervaringen in of uit te schakelen.

Geeft toegang om je community's te beheren.

Geeft toestemming om communitygegevens te lezen.

Verleent toestemmingen voor communitybeheer.

Geeft toegang om je lokalisatietabellen te lezen en te schrijven

Geeft toegang om teamsamenwerking te beheren voor alle ervaringen die je bezit.

Geeft toegang om je ervaringen en bepaalde informatie die aan je ervaringen is gekoppeld (bijv. lokalisatie-informatie) te beheren.

Geeft toegang om de lokalisatie-informatie van je ervaringen te lezen.

Geeft toegang om de lokalisatievoorkeuren van je ervaringen te wijzigen.

Geeft toegang om je gebruikersaccount te beheren.

Geeft toegang om de lokalisatievoorkeuren van de gebruiker te wijzigen.

Hiermee kun je de status, logs en resultaten van Luau-uitvoeringstaken voor de bijbehorende plaats bekijken.

Hiermee kun je nieuwe Luau-uitvoeringstaken voor de bijbehorende plaats maken.

Geeft toegang om asynchroon alle gegevensstructuren in het universum te flushen.

Geeft toegang om nieuwe wachtrijitems te maken.

Geeft toegang om gelezen items vooraan in de wachtrij te negeren.

Geeft toegang tot gelezen items vooraan in de wachtrij.

Geeft toegang om je geheugenopslagitems te lezen.

Geeft toegang om kaartitems te maken, bij te werken en te verwijderen.

Dit geeft de mogelijkheid om namens gebruikers berichten te publiceren.

Hiermee kun je meldingen vanuit je ervaring naar gebruikers sturen.

(Verouderd) Geeft toegang om een lijst met items in een genummerde gegevensopslag te lezen.

(Verouderd) Geeft toegang om een nieuw item in een genummerde gegevensopslag te maken.

Geeft toegang om items uit een genummerde gegevensopslag te vermelden.

Geeft toegang om items in een genummerde gegevensopslag te maken.

Hiermee kun je geheimen vermelden die aan je ervaring zijn gekoppeld.

Hiermee kun je geheimen maken en bijwerken die aan je ervaring zijn gekoppeld.

Met deze toestemming kun je een evaluatietaak indienen en het resultaat van de taak bekijken.

Geeft toegang om informatie over je abonnementsproducten te lezen.

Hiermee kun je namens jou informatie over miniaturen lezen.

Geeft de mogelijkheid om analytics-waarschuwingen te lezen.

Geeft de mogelijkheid om analytics-waarschuwingen te maken of te wijzigen.

Geeft de mogelijkheid om game analytics te lezen.

Geeft de mogelijkheid om bronnen met betrekking tot game analytics te schrijven.

Geeft de mogelijkheid om plaatsinformatie te lezen.

Geeft de mogelijkheid om plaatsinformatie te bewerken.

Geeft toegang om nieuwe versies van ervaringen op Roblox te publiceren.

Hiermee kun je de miniaturen en de bijbehorende personalisatie-instellingen voor je ervaringen lezen.

Hiermee kun je de miniaturen uploaden en verwijderen en de bijbehorende personalisatie-instellingen voor je ervaringen beheren.

Geeft de mogelijkheid om informatie over ervaringen te lezen.

Geeft toegang om de ervaringen van de geautoriseerde gebruiker te bewerken.

Hiermee kun je de gebruikersbeperkingen in de ervaring bekijken.

Hiermee kun je de gebruikersbeperkingen in de ervaring bewerken.

Hiermee kun je meldingen bekijken die naar je account zijn gestuurd.

Geeft de mogelijkheid om de premium- en geverifieerde status van de gebruiker te lezen.

Hiermee kun je de sociale media-accounts van de geautoriseerde gebruiker bekijken.

Geeft de mogelijkheid om game-evenementen te lezen.

Geeft de mogelijkheid om game-evenementen te bewerken.

Dit schakelt de Single Sign-On-functionaliteit in.

Dit geeft toegang om je profielinformatie te lezen.

Samenvatting