Callback ini dipanggil sekali untuk setiap pemain, segera setelah tingkat kepercayaan
perangkat mereka tersedia. Gunakan ini untuk memutuskan apakah pemain dapat tetap di
server, berdasarkan `Class.Player.DeviceTrustLevel` dan tabel `measures`.

Perhatikan hal-hal berikut saat Anda menetapkan callback ini:

- Anda hanya dapat menetapkannya dari `Class.Script` sisi server. Menetapkannya
  dari klien akan menghasilkan kesalahan.
- Setiap tempat memiliki satu callback. Jika Anda menetapkannya lebih dari sekali,
  penetapan terakhir akan menggantikan yang sebelumnya.
- Ini dijalankan setelah `Class.Players.PlayerAdded` dipicu, karena memeriksa
  perangkat memerlukan waktu. Ketika dijalankan, `Class.Player.DeviceTrustLevel` tidak
  pernah `Enum.PlayerDeviceTrustLevel.Pending|Pending`.
- Ini dapat yield. Pemain tetap bermain saat ini berjalan, jadi pemain yang ditolak
  dapat terputus setelah mereka mulai bermain.
- Jika pemain meninggalkan, atau skrip Anda menghapus mereka, sebelum tingkat kepercayaan
  mereka tersedia, itu tidak dipanggil untuk pemain tersebut.
- Roblox tidak memeriksa perangkat di Studio, jadi tidak dipanggil selama
  playtest.

Roblox memfilter `Message` kustom dan mempersingkat pesan yang terlalu panjang.
Jika pemfilteran akan mengubah pesan, Roblox menunjukkan pesan default
sebagai gantinya.

Roblox tidak mengeluarkan pemain dalam setiap kasus berikut:

- Tidak ada skrip yang menetapkan callback.
- Callback mengembalikan `nil`, nilai yang bukan tabel, atau tabel
  tanpa `Action` yang valid.
- Callback menghasilkan kesalahan. Roblox melaporkan kesalahan seperti kesalahan skrip
  lainnya.
- Callback tidak mengembalikan tepat waktu.

Untuk contoh kode, lihat
[kepercayaan perangkat](/scripting/security/device-trust).


IntegrityService.EvaluatePlayerDeviceTrust

player

`Class.Player` yang sedang dievaluasi. Tingkat kepercayaan mereka sudah diatur
pada `Class.Player.DeviceTrustLevel` saat callback ini dijalankan.


measures

Sebuah tabel pasangan kunci-nilai yang menjelaskan tingkat kepercayaan perangkat pemain.
Sebuah nilai `true` berarti perangkat tersebut lulus ukuran tersebut:

- `IsPlatformVersionSecure` &mdash; Sistem operasi berada pada atau
  di atas versi minimum yang dianggap aman oleh Roblox.
- `IsPlatformBootSecure` &mdash; Sistem operasi dimulai dalam keadaan
  aman.
- `IsAppSecure` &mdash; Aplikasi Roblox tidak telah dimanipulasi.

Sebuah ukuran yang tidak tersedia di perangkat membaca `true`, jadi selalu
periksa juga `Class.Player.DeviceTrustLevel`.


Sebuah tabel yang memberi tahu Roblox apa yang harus dilakukan dengan pemain, atau `nil` untuk membiarkan
mereka:

- `Action` &mdash; Wajib. `Enum.PlayerDeviceTrustDecision.Reject`
  memutuskan pemain. `Enum.PlayerDeviceTrustDecision.Accept`
  membiarkan mereka.
- `Message` &mdash; Opsional. Pesan yang dilihat pemain yang ditolak.
  Jika Anda menghilangkannya, Roblox menunjukkan pesan default yang menjelaskan bagaimana
  pemain mungkin memperbaiki perangkat mereka.


Memutuskan apakah seorang pemain dapat tetap di server setelah tingkat kepercayaan
perangkat mereka tersedia.


`IntegrityService` mengekspos API untuk mengukur
[tingkat kepercayaan perangkat](/scripting/security/device-trust) dari setiap
pemain yang bergabung dengan permainan Anda. Roblox tidak mengambil tindakan berdasarkan
tingkat kepercayaan perangkat; sebaliknya, Anda memutuskan apa artinya untuk pengalaman Anda,
seperti menolak pemain di perangkat yang tidak tepercaya, membatasi fitur sensitif, atau
mengirim pemain ke tempat yang berbeda.

Untuk menerima atau menolak setiap pemain setelah tingkat kepercayaan mereka tersedia,
berikan fungsi ke
`Class.IntegrityService.EvaluatePlayerDeviceTrust|EvaluatePlayerDeviceTrust`.
Untuk membaca tingkat kepercayaan seorang pemain kapan saja, gunakan
`Class.Player.DeviceTrustLevel`.

Tingkat kepercayaan perangkat menggambarkan perangkat pemain, bukan pemain atau akun mereka.
**Ini tidak memberi tahu Anda apakah seorang pemain sedang curang.** Untuk contoh kode
dan panduan tentang memilih kebijakan, lihat
[kepercayaan perangkat](/scripting/security/device-trust).


IntegrityService

Sebuah layanan yang memungkinkan Anda memutuskan bagaimana pengalaman Anda merespons tingkat
kepercayaan perangkat setiap pemain.


`Instance` adalah kelas dasar untuk semua kelas dalam hierarki kelas Roblox
yang dapat menjadi bagian dari pohon `Class.DataModel`.

Tidak mungkin untuk secara langsung membuat objek `Instance` root, tetapi
konstruktor khusus `Datatype.Instance.new()` membuat objek melalui kode,
mengambil nama kelas sebagai parameter dan mengembalikan objek yang dibuat.


Menunjukkan cara mendeteksi perubahan pada leluhur sebuah instance dengan menghubungkan ke
`Class.Instance.AncestryChanged` event.

Parent dari ChangingPart diatur ke nilai yang berbeda seiring waktu. Parent dari
part adalah leluhur part, jadi event `Class.Instance.AncestryChanged`
akan dipicu setiap kali terjadi perubahan.

Ditembak saat instance ini dipindahkan atau saat salah satu nenek moyangnya
dipindahkan.

Anda dapat menggunakan peristiwa ini untuk melacak penghapusan instance di Studio,
seperti penghapusan manual di Explorer atau melalui plugin. Jika Anda perlu
deteksi saat instance dihancurkan menggunakan `Class.Instance:Destroy()`,
gunakan peristiwa `Class.Instance.Destroying` sebagai gantinya.


Instance.AncestryChanged

child

Instance yang properti `Class.Instance.Parent|Parent`-nya diubah,
yang bisa jadi instance ini atau nenek moyang yang lebih jauh, **bukan**
harus instance yang terhubung ke handler.


parent

Ditembak saat properti `Class.Instance.Parent` dari objek ini atau salah satu
nenek moyangnya diubah.


Peristiwa ini ditembak setiap kali atribut diubah pada instance,
termasuk saat atribut diatur ke `nil`. Nama atribut yang diubah
akan diteruskan ke fungsi yang terhubung.

Misalnya, cuplikan kode berikut menghubungkan fungsi `attributeChanged()`
untuk ditembak setiap kali salah satu atribut bagian berubah:

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

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "berubah")
end

part.AttributeChanged:Connect(attributeChanged)
```
Lihat juga `Class.Instance:GetAttributeChangedSignal()` yang mengembalikan
peristiwa yang ditembak saat atribut tertentu diubah.


Instance.AttributeChanged

attribute

Ditembak setiap kali atribut diubah pada `Class.Instance`.


Cuplikan ini mencetak nama objek saat mereka ditambahkan ke Workspace:

Ditembak setelah objek dipindahkan ke `Class.Instance` ini.

Catatan, saat menggunakan metode ini di klien untuk mendeteksi objek yang dibuat oleh
server, perlu menggunakan `Class.Instance:WaitForChild()` saat
mengindeks keturunan objek ini. Ini karena objek dan keturunannya tidak
jaminan untuk direplikasi dari server ke klien secara bersamaan. Misalnya:

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

Workspace.ChildAdded:Connect(function(child)
	-- Gunakan WaitForChild() karena keturunan mungkin belum direplikasi
	local head = child:WaitForChild("Head")
end)
```
Catatan, peristiwa ini hanya beroperasi untuk anak langsung dari
`Class.Instance`. Untuk peristiwa yang menangkap semua keturunan, gunakan
`Class.Instance.DescendantAdded`.

Lihat juga `Class.Instance.ChildRemoved`.


Instance.ChildAdded

`Class.Instance` yang telah ditambahkan.


Ditembak setelah objek dipindahkan ke `Class.Instance` ini.


Instance.childAdded

Potongan ini mencetak nama objek saat mereka dihapus dari Workspace:

Ditembak setelah anak dihapus dari `Class.Instance` ini.

Dihapus mengacu pada saat induk objek diubah dari `Class.Instance` ini
ke sesuatu selain `Class.Instance` ini. Catatan, peristiwa ini juga
akan ditembak saat anak dihancurkan (menggunakan
`Class.Instance:Destroy()`) karena fungsi hancur mengatur induk objek
ke `nil`.

Peristiwa ini hanya beroperasi untuk anak langsung dari `Class.Instance`.
Untuk peristiwa yang menangkap semua keturunan, gunakan
`Class.Instance.DescendantRemoving`.

Lihat juga `Class.Instance.ChildAdded`.


Instance.ChildRemoved

Ditembak setelah anak dihapus dari `Class.Instance` ini.


Contoh berikut akan mencetak nama objek apa pun yang ditambahkan ke
Workspace:

Peristiwa ini ditembak setelah keturunan ditambahkan ke `Class.Instance`.

Karena ini ditembak untuk setiap keturunan, memindahkan objek ke
`Class.Instance` akan menembakkan peristiwa untuk objek ini dan semua
keturunannya secara individu.

Jika Anda hanya peduli dengan **anak langsung** dari
`Class.Instance`, gunakan `Class.Instance.ChildAdded` sebagai gantinya.

Lihat juga `Class.Instance.DescendantRemoving`.


Instance.DescendantAdded

descendant

Ditembak setelah keturunan ditambahkan ke `Class.Instance`.


Contoh berikut mencetak nama dari setiap keturunan saat sedang dihapus
 dari Workspace:

Peristiwa ini ditembak **segera sebelum** induk `Class.Instance`
berubah sehingga instance **keturunan** tidak lagi menjadi
keturunan. `Class.Instance:Destroy()|Destroy()` mengubah `Class.Instance.Parent|Parent`
sehingga menjadi `nil`, jadi memanggil metode itu pada keturunan induk
akan menyebabkan peristiwa ini ditembak.

Karena peristiwa ini ditembak **sebelum** penghapusan keturunan, induk dari
keturunan tidak akan berubah pada saat peristiwa ini ditembak. Jika keturunan
juga merupakan **anak langsung** dari induk, peristiwa ini akan ditembak
sebelum `Class.Instance.ChildRemoved`.

Jika keturunan memiliki anak, peristiwa ini ditembak dengan keturunan terlebih dahulu,
dilanjutkan dengan keturunannya.

#### Peringatan

Peristiwa ini ditembak dengan objek keturunan yang sedang dihapus.
Mencoba mengatur `Class.Instance.Parent|Parent` dari keturunan ke
sesuatu yang lain akan gagal. Berikut adalah contoh yang menunjukkan hal ini:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Jangan manipulasi induk keturunan dalam fungsi ini!
	-- Peristiwa ini ditembak KARENA induk dimanipulasi, dan perubahan belum terjadi
	-- Oleh karena itu, problematik untuk mengubah induk seperti ini:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Lihat juga `Class.Instance.DescendantAdded|DescendantAdded`.


Instance.DescendantRemoving

Ditembak segera sebelum keturunan dari `Class.Instance` dihapus.


Contoh ini menunjukkan bagaimana, saat menggunakan perilaku sinyal Segera, sebuah
Instance yang dihancurkan tetap berada di tempatnya sampai fungsi yang terhubung menunggu.

Contoh ini menunjukkan bagaimana, ketika menggunakan perilaku sinyal Tertunda, sebuah Instance
 dihancurkan sebelum sinyal dipicu.

`Class.Instance` tidak akan pernah dihapus dari memori selama fungsi yang terhubung
masih menggunakannya. Namun, jika fungsi tersebut menunggu pada titik mana pun,
`Class.Instance` dan keturunannya akan dipindahkan ke `nil`.

Jika properti `Class.Workspace.SignalBehavior` diatur ke
`Enum.SignalBehavior.Immediate`, peristiwa ini ditembak segera sebelum
`Class.Instance` atau salah satu nenek moyangnya dihancurkan dengan
`Class.Instance:Destroy()`.

Jika properti `Class.Workspace.SignalBehavior` diatur ke
`Enum.SignalBehavior.Deferred`, peristiwa ini ditembak pada titik
resumsi berikutnya, yang akan terjadi setelah `Class.Instance` atau salah satu
nenek moyangnya dihancurkan dengan `Class.Instance:Destroy()`.

Dengan perilaku `Enum.SignalBehavior.Deferred|Deferred`, menghubungkan skrip
ke peristiwa `Class.Instance.Destroying` sendiri menjadi problematik, karena skrip
akan dihancurkan sebelum callback dapat dipanggil (artinya tidak akan
menjalankan).

Saat menghapus `Class.Instance` di Studio, seperti menghapus secara manual
melalui [Explorer](/studio/explorer) atau melalui plugin,
`Class.Instance` tidak dihancurkan. Sebaliknya, induk diatur ke `nil`
yang dapat Anda lacak dengan `Class.Instance.AncestryChanged`.


Instance.Destroying

Ditembak segera sebelum (atau ditunda hingga setelah) instance dihancurkan
melalui `Class.Instance:Destroy()`.


Mendemonstrasikan `Class.Instance.StyledPropertiesChanged`.


Peristiwa ini ditembak setiap kali properti gaya diubah pada instance,
termasuk saat properti diatur ke `nil`.


Instance.StyledPropertiesChanged

Ditembak setiap kali properti gaya diubah pada instance, termasuk
saat properti diatur ke `nil`.


Metode ini menerapkan tag pada instance, tanpa efek jika tag sudah diterapkan.
Menambahkan tag dengan sukses akan memicu sinyal yang dibuat oleh
`Class.CollectionService:GetInstanceAddedSignal()` dengan tag yang diberikan.

#### Peringatan

- Tag instance yang ditambahkan di sisi klien akan dihapus jika server
  kemudian menambahkan atau menghapus tag pada instance tersebut karena server
  mereplikasi semua tag bersama-sama dan menimpa tag sebelumnya.

- Saat memberi tag pada instance, umum bahwa beberapa sumber daya digunakan untuk
  memberikan fungsionalitas tag, misalnya koneksi acara atau tabel.
  Untuk mencegah kebocoran memori, adalah ide yang baik untuk membersihkannya
  (putuskan sambungan, atur ke `nil`, dll.) saat tidak lagi diperlukan untuk tag.
  Lakukan ini saat memanggil `Class.Instance:RemoveTag()`, memanggil
  `Class.Instance:Destroy()`, atau dalam fungsi yang terhubung ke sinyal
  yang dikembalikan oleh `Class.CollectionService:GetInstanceRemovedSignal()`.


Instance:AddTag

Fungsi anak mengembalikan array dari anak-anak objek.


Instance:children

Mengembalikan array dari anak-anak objek.


Metode ini menghancurkan semua anak dari sebuah instance dan keturunannya.

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

-- Tambahkan beberapa kilau
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

  local sc = Instance.new("Sparkles")
  sc.Parent = sparkles
end

print("Children:", #part:GetChildren())  --> Children: 3

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> Children: 0
```
Jika Anda tidak ingin menghancurkan **semua** anak dan keturunan, gunakan
`Class.Instance:GetChildren()` atau `Class.Instance:GetDescendants()` untuk
melalui anak-anak/keturunan tersebut dan memilih apa yang akan dihancurkan. Sebagai
contoh, cuplikan kode berikut akan menghancurkan semua
`Class.BasePart|BaseParts` yang diturunkan dari `Class.Model`:

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

local model = Workspace:FindFirstChild("TestModel")

for _, descendant in model:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant:Destroy()
	end
end
```


Instance:ClearAllChildren

Metode ini menghancurkan semua anak dari sebuah instance.


Menunjukkan cara mengkloning sebuah model menggunakan `Class.Instance:Clone()`.

`Clone()` membuat salinan dari sebuah instance dan semua keturunannya,
mengabaikan semua instance yang tidak
`Class.Instance.Archivable|Archivable`. Salinan dari instance root dikembalikan
oleh metode ini dan `Class.Instance.Parent|Parent` diatur ke
`nil`. Perhatikan bahwa jika instance itu sendiri memiliki
`Class.Instance.Archivable|Archivable` diatur ke `false`, metode ini akan
mengembalikan `nil`.

Jika properti referensi seperti `Class.ObjectValue.Value` diatur dalam
instance yang disalin, nilai dari properti salinan tergantung pada
nilai aslinya:

- Jika properti referensi merujuk pada instance yang **juga** disalin,
  salinan akan merujuk pada salinan tersebut.
- Jika properti referensi merujuk pada instance yang **tidak** disalin,
  nilai yang sama dipertahankan dalam salinan.


Instance:Clone

Salinan dari instance, atau `nil` jika instance tidak
`Class.Instance.Archivable|Archivable`.


Membuat salinan dari sebuah instance dan semua keturunannya, mengabaikan instance
yang tidak `Class.Instance.Archivable|Archivable`.


Instance:clone

Menunjukkan cara menghancurkan sebuah Part menggunakan fungsi `Class.Instance:Destroy()`.

Fungsi ini adalah cara yang benar untuk membuang objek yang tidak lagi
dibutuhkan.

Mengatur properti `Class.Instance.Parent` menjadi `nil`, mengunci
properti `Class.Instance.Parent`, memutuskan semua koneksi, dan memanggil
`Destroy()` pada semua anak. Metode ini adalah cara yang benar untuk membuang
objek yang tidak lagi diperlukan.

Membuang objek yang tidak diperlukan itu penting, karena objek dan
koneksi yang tidak perlu di suatu tempat menggunakan memori yang dapat
menyebabkan masalah kinerja yang serius seiring waktu.

Sebagai praktik terbaik setelah memanggil `Destroy()` pada sebuah objek,
aturkan variabel yang merujuk pada objek (atau keturunannya) menjadi `nil`. Ini
mencegah kode Anda mengakses apa pun yang berhubungan dengan objek tersebut.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- Jangan lakukan ini:
print(part.Name)  --> "Hello, world"
-- Lakukan ini untuk mencegah baris di atas berfungsi:
part = nil
```
Setelah `Class.Instance` dihancurkan oleh metode ini, tidak dapat digunakan
kembali karena properti `Class.Instance.Parent` terkunci. Untuk
**sementara** menghapus objek alih-alih menghancurkannya, atur
`Class.Instance.Parent|Parent` menjadi `nil`. Sebagai contoh:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Untuk menghancurkan objek setelah waktu tertentu, gunakan
`Class.Debris:AddItem()`.


Instance:Destroy

Mengatur properti `Class.Instance.Parent` menjadi `nil`, mengunci
properti `Class.Instance.Parent`, memutuskan semua koneksi, dan memanggil
`Destroy()` pada semua anak.


Instance:destroy

Mengembalikan nenek moyang pertama dari `Class.Instance` yang
`Class.Instance.Name` sama dengan nama yang diberikan.

Metode ini bekerja ke atas, artinya dimulai dari `Class.Instance.Parent`
yang langsung dan bekerja ke atas menuju `Class.DataModel`. Jika tidak
ada nenek moyang yang cocok ditemukan, ia mengembalikan `nil`.

Cuplikan kode berikut akan menemukan nenek moyang pertama dari objek
bernama `Car`.

```
local car = object:FindFirstAncestor("Car")
```
Untuk varian dari metode ini yang menemukan nenek moyang dari kelas tertentu,
lihat `Class.Instance:FindFirstAncestorOfClass()` dan
`Class.Instance:FindFirstAncestorWhichIsA()`.


Instance:FindFirstAncestor

name

Nama `Class.Instance.Name` yang akan dicari.


Mengembalikan nenek moyang pertama dari `Class.Instance` yang
`Class.Instance.Name` sama dengan nama yang diberikan.


Mengembalikan nenek moyang pertama dari `Class.Instance` yang
`Class.Object.ClassName` sama dengan className yang diberikan.

Metode ini bekerja ke atas, artinya dimulai dari `Class.Instance.Parent`
yang langsung dan bekerja ke atas menuju `Class.DataModel`. Jika tidak
ada nenek moyang yang cocok ditemukan, ia mengembalikan `nil`.

Penggunaan umum dari metode ini adalah menemukan `Class.Model` yang
`Class.BasePart` miliki. Sebagai contoh:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Metode ini adalah varian dari `Class.Instance:FindFirstAncestor()` yang
memeriksa properti `Class.Object.ClassName` alih-alih
`Class.Instance.Name`. `Class.Instance:FindFirstAncestorWhichIsA()` juga
ada, menggunakan metode `Class.Object:IsA()` sebagai gantinya untuk menghormati
pewarisan kelas.


Instance:FindFirstAncestorOfClass

className

Nama `Class.Object.ClassName` yang akan dicari.


Mengembalikan nenek moyang pertama dari `Class.Instance` yang
`Class.Object.ClassName` sama dengan className yang diberikan.


Mengembalikan nenek moyang pertama dari `Class.Instance` untuk siapa
`Class.Object:IsA()` mengembalikan true untuk className yang diberikan.

Metode ini bekerja ke atas, artinya dimulai dari `Class.Instance.Parent`
yang langsung dan bekerja ke atas menuju `Class.DataModel`. Jika tidak
ada nenek moyang yang cocok ditemukan, ia mengembalikan `nil`.

Berbeda dengan `Class.Instance:FindFirstAncestorOfClass()`, metode ini menggunakan
`Class.Object:IsA()` yang menghormati pewarisan kelas. Sebagai contoh:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Oleh karena itu, cuplikan kode berikut akan mengembalikan nenek moyang pertama
`Class.BasePart`, terlepas dari apakah itu adalah `Class.WedgePart`,
`Class.MeshPart` atau `Class.Part`.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Lihat juga `Class.Instance:FindFirstAncestor()`.


Instance:FindFirstAncestorWhichIsA

Mengembalikan nenek moyang pertama dari `Class.Instance` untuk siapa
`Class.Object:IsA()` mengembalikan true untuk className yang diberikan.


Di bawah ini akan mencari di Workspace untuk objek dengan nama "Brick". Jika ditemukan,
akan mengganti nama objek tersebut menjadi "Foo".

Mengembalikan anak pertama dari `Class.Instance` dengan nama yang diberikan, atau
`nil` jika tidak ada anak seperti itu yang ada. Jika argumen opsional `recursive`
`true`, metode ini mencari semua keturunan alih-alih hanya anak langsung dari `Class.Instance`.

#### Memeriksa Keberadaan Objek

`FindFirstChild()` diperlukan jika Anda perlu memverifikasi keberadaan objek
sebelum melanjutkan. Mencoba mengindeks anak dengan nama menggunakan operator titik
akan menghasilkan kesalahan jika anak tersebut tidak ada.

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

-- Baris berikut menghasilkan kesalahan jika bagian tidak ada di workspace
Workspace.Part.Transparency = 0.5
```
Pendekatan yang lebih baik adalah menggunakan `FindFirstChild()` untuk terlebih dahulu memeriksa `Part`,
kemudian menggunakan pernyataan `if` untuk menjalankan kode yang membutuhkannya.

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

local part = Workspace:FindFirstChild("Part")
if part then
	part.Transparency = 0.5
end
```

#### Menemukan Anak yang Nama Sesuai dengan Properti

Terkadang `Class.Instance.Name|Name` dari sebuah objek sama dengan
properti dari `Class.Instance.Parent|Parent`-nya. Saat menggunakan operator titik,
properti memiliki prioritas lebih tinggi daripada anak jika mereka memiliki nama yang sama.

Dalam contoh berikut, sebuah `Class.Folder` bernama `Color` ditambahkan ke
`Class.Part`, yang juga memiliki properti `Class.Part.Color`. Perhatikan bahwa
`part.Color` merujuk pada nilai properti `Datatype.Color3`, bukan instance folder anak `Class.Folder`. Sebuah keuntungan dari menggunakan
`Class.Instance:FindFirstChild()|FindFirstChild()` adalah bahwa
pengenalan properti baru tidak menimbulkan risiko pada kode Anda.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- Properti
local c2 = part:FindFirstChild("Color")  -- Folder anak
```

#### Catatan Kinerja

`Class.Instance:FindFirstChild()|FindFirstChild()` memakan waktu sekitar 20% lebih lama
daripada menggunakan operator titik dan hampir 8 kali lebih lama daripada hanya menyimpan
referensi ke sebuah objek. Oleh karena itu, Anda harus menghindari memanggilnya dalam
kode yang bergantung pada kinerja seperti dalam loop ketat atau fungsi yang terhubung
ke `Class.RunService.Heartbeat` dan `Class.RunService.PreRender`. Sebagai gantinya,
sebaiknya simpan hasilnya dalam variabel, atau pertimbangkan untuk menggunakan
`Class.Instance.ChildAdded|ChildAdded` atau
`Class.Instance:WaitForChild()|WaitForChild()` untuk mendeteksi kapan anak dengan nama tertentu menjadi tersedia.


Instance:FindFirstChild

recursive

Apakah pencarian harus dilakukan secara rekursif atau tidak.


Mengembalikan anak pertama dari `Class.Instance` yang ditemukan dengan nama yang diberikan.


Instance:findFirstChild

Mengembalikan anak pertama dari `Class.Instance` yang
`Class.Object.ClassName|ClassName` sama dengan `className` yang diberikan.
Berbeda dengan `Class.Instance:FindFirstChildWhichIsA()`, metode ini hanya mengembalikan
objek yang kelasnya cocok dengan `className`, mengabaikan pewarisan kelas. Jika tidak
ada anak yang cocok ditemukan, metode ini mengembalikan `nil`.


Instance:FindFirstChildOfClass

Mengembalikan anak pertama dari `Class.Instance` yang
`Class.Object.ClassName|ClassName` sama dengan nama kelas yang diberikan.


Mengembalikan anak pertama dari `Class.Instance` untuk siapa
`Class.Object:IsA()` mengembalikan true untuk className yang diberikan.

Jika tidak ada anak yang cocok ditemukan, metode ini mengembalikan `nil`. Jika argumen
opsional rekursif bernilai true, metode ini mencari semua keturunan alih-alih hanya
anak langsung dari `Class.Instance`.

Berbeda dengan `Class.Instance:FindFirstChildOfClass()`, metode ini menggunakan
`Class.Object:IsA()` yang menghormati pewarisan kelas. Sebagai contoh:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Oleh karena itu, cuplikan kode berikut akan mengembalikan anak pertama
`Class.BasePart`, terlepas dari apakah itu adalah `Class.WedgePart`,
`Class.MeshPart` atau `Class.Part`.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Pengembang yang mencari anak berdasarkan nama, sebaiknya menggunakan
`Class.Instance:FindFirstChild()` sebagai gantinya.


Instance:FindFirstChildWhichIsA

Mengembalikan anak pertama dari `Class.Instance` untuk siapa
`Class.Object:IsA()` mengembalikan true untuk className yang diberikan.


Mengembalikan keturunan pertama yang ditemukan dengan `Class.Instance.Name` yang diberikan.

Metode ini dinonaktifkan dan tidak dapat digunakan. Untuk menemukan keturunan pertama
sebuah instance, pertimbangkan untuk menggunakan parameter `recursive` pada
`Class.Instance:FindFirstChild()` sebagai gantinya.


Instance:FindFirstDescendant

Mengembalikan keturunan pertama yang ditemukan dengan `Class.Instance.Name` yang diberikan.


Jika `Class.Instance` adalah `Class.Actor`, `Class.Actor` itu sendiri akan
kembali. Jika tidak, nenek moyang terdekatnya `Class.Actor` akan dikembalikan. Jika tidak
ada nenek moyang yang merupakan `Class.Actor`, hasilnya adalah `nil`.


Instance:GetActor

Mengembalikan `Class.Actor` yang terkait dengan Instance, jika ada.


Metode ini mengembalikan nilai yang telah ditetapkan untuk nama
atribut yang diberikan. Jika tidak ada atribut yang ditetapkan, `nil` dikembalikan.

Sebagai contoh, cuplikan kode berikut mengatur dan kemudian mendapatkan nilai dari
atribut `InitialPosition` instance:

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

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local initialPosition = instance:GetAttribute("InitialPosition")
print(initialPosition)
```

#### Lihat Juga

- `Class.Instance:SetAttribute()` yang mengatur atribut dengan nama yang diberikan
  ke nilai yang diberikan.
- `Class.Instance:GetAttributes()` yang mengembalikan kamus pasangan kunci-nilai
  untuk setiap atribut instance.


Instance:GetAttribute

Nilai yang telah ditetapkan untuk nama atribut yang diberikan. Jika tidak ada
atribut yang ditetapkan, `nil` dikembalikan.


Mengembalikan nilai yang telah ditetapkan untuk nama atribut yang diberikan.


Metode ini mengembalikan sebuah acara yang berfungsi persis seperti
acara `Class.Object.Changed|Changed`, kecuali bahwa ia hanya dipicu ketika
atribut yang diberikan berubah; secara efektif mirip dengan
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` tetapi
untuk atribut.

Umumnya adalah ide yang baik untuk menggunakan metode ini alih-alih koneksi ke
`Class.Object.Changed|Changed` dengan fungsi yang memeriksa nama atribut.
Panggilan berikutnya ke metode ini pada objek yang sama dengan nama atribut yang sama
mengembalikan acara yang sama.

Cuplikan kode berikut mengembalikan sinyal yang memicu fungsi
`attributeChanged()` ketika atribut `InitialPosition` bagian berubah:

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

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local function attributeChanged()
	print("Atribut berubah")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Lihat juga `Class.Instance.AttributeChanged` yang dipicu setiap kali atribut
apa pun diubah pada instance.


Instance:GetAttributeChangedSignal

Nama atribut yang ditentukan untuk sinyal perubahan yang
sedang dikembalikan.


Sebuah acara yang dipicu ketika atribut yang diberikan berubah.


Mengembalikan sebuah acara yang dipicu ketika atribut yang diberikan berubah.


Metode ini mengembalikan kamus pasangan kunci-nilai untuk setiap atribut
di mana kunci adalah nama atribut dan nilai adalah nilai yang tidak `nil`.

Sebagai contoh, cuplikan kode berikut mengeluarkan atribut dan nilai dari
sebuah instance:

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

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)
part:SetAttribute("CanUse", true)

for name, value in part:GetAttributes() do
	print(name .. " = " .. value)
end
```
Lihat juga `Class.Instance:GetAttribute()` yang mengembalikan nilai yang telah
ditetapkan untuk nama atribut yang diberikan.


Instance:GetAttributes

Sebuah kamus pasangan string → varian untuk setiap atribut di mana
string adalah nama atribut dan varian adalah nilai yang tidak-nil.


Mengembalikan kamus atribut dari instance.


Di bawah ini akan mencetak nama semua objek yang saat ini ada di Workspace saat dijalankan.

Mengembalikan array (tabel yang diindeks secara numerik) yang berisi semua
anak langsung dari instance, atau setiap `Class.Instance` yang
`Class.Instance.Parent|Parent` sama dengan objek tersebut. Array dapat
iterasi menggunakan loop numerik atau loop generik:

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

-- Contoh loop numerik
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " adalah anak nomor " .. i)
end
```

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

-- Contoh loop generik
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " adalah anak nomor " .. i)
end
```
Perhatikan bahwa array yang dikembalikan **tidak** diurutkan dalam urutan tertentu,
jadi pengurutan manual (misalnya menggunakan `Library.table.sort()`) disarankan untuk
mengurutkan anak-anak yang dikembalikan oleh metode ini.

Lihat juga metode `Class.Instance:GetDescendants()|GetDescendants()`.


Instance:GetChildren

Mengembalikan array yang berisi semua anak dari instance.


Instance:getChildren

Mengembalikan string kode dari ID debug yang digunakan secara internal oleh Roblox. Perhatikan
bahwa:

- Item ini dilindungi. Mencoba menggunakannya dalam `Class.Script` atau
  `Class.LocalScript` akan menyebabkan kesalahan.
- ID debug adalah ID yang digunakan dalam proses debugging. Ini memungkinkan debugger untuk
  membaca setiap instruksi sebelum aplikasi memprosesnya. Semua objek di
  Roblox bertindak seperti proses dan setiap menjalankan instruksi (atau 'kode') yang dapat
  di-debug jika diperlukan.
- Ini dapat membantu untuk plugin yang perlu membedakan objek serupa satu sama lain
  (seperti objek yang memiliki nama yang sama).


Instance:GetDebugId

scopeLength

Mengembalikan string kode dari ID debug yang digunakan secara internal oleh Roblox.


GetDescendants sering digunakan untuk melakukan sesuatu kepada semua keturunan yang merupakan
jenis objek tertentu. Kode dalam contoh ini menggunakan GetDescendants dan
`Class.Instance:IsA()` untuk menemukan semua bagian di workspace dan mengubah
warna mereka menjadi hijau.

Metode objek ini mengembalikan array yang berisi semua keturunan
objek tersebut. Berbeda dengan `Class.Instance:GetChildren()`, yang hanya mengembalikan
anak langsung dari sebuah objek, metode ini menemukan setiap anak dari objek,
every child of those children, dan seterusnya.

Perhatikan bahwa array yang dikembalikan **tidak** diurutkan dalam urutan tertentu,
jadi pengurutan manual (misalnya menggunakan `Library.table.sort()`) disarankan untuk
mengurutkan keturunan yang dikembalikan oleh metode ini. Juga pertimbangkan
metode `Class.Instance:QueryDescendants()|QueryDescendants()` untuk men-query
keturunan dengan kombinasi pemilih dan penggabung.


Instance:GetDescendants

Mengembalikan array yang berisi semua keturunan dari instance.


Contoh kode ini menunjukkan perilaku dari `Class.Instance:GetFullName()`.
Ini menunjukkan bagaimana fungsi berperilaku saat dipanggil pada objek yang tidak berada di
hierarki `DataModel`, dan juga menunjukkan bagaimana nilai yang dikembalikan tidak meloloskan
karakter khusus.

Contoh kode ini mengimplementasikan kembali fungsi `Class.Instance:GetFullName()` dalam
Lua.


Mengembalikan string yang menggambarkan nenek moyang instance. String ini adalah
konkatenasi dari `Class.Instance.Name|Name` objek dan nenek moyangnya,
yang dipisahkan oleh titik. `Class.DataModel` (`game`) tidak dianggap. Sebagai contoh, sebuah `Class.Part` di dalam `Class.Workspace` dapat
mengembalikan `Class.Workspace.Part`.

Ketika dipanggil pada `Class.Instance` yang bukan keturunan dari
`Class.DataModel`, metode ini mempertimbangkan semua nenek moyang hingga dan termasuk
nenek moyang teratas yang tidak memiliki `Class.Instance.Parent|Parent`.

Metode ini berguna untuk logging dan debugging. Anda tidak boleh mencoba untuk
mem-parsing string yang dikembalikan untuk operasi yang berguna; metode ini tidak
menghindari titik (atau simbol lainnya) dalam nama objek. Dengan kata lain,
meskipun outputnya sering tampak sebagai pengidentifikasi Luau yang valid, itu tidak
jamin.


Instance:GetFullName

Mengembalikan string yang menggambarkan nenek moyang instance.


Mendemonstrasikan `Class.Instance:GetStyled()`.


Metode ini mengembalikan nilai yang telah ditata atau dimodifikasi secara eksplisit dari
properti yang ditentukan, atau nilai properti default jika belum ditata/dimodifikasi. Ini sedikit berbeda dari mengakses nilai properti
secara langsung, seperti `[GuiObject].Rotation`, yang mengembalikan nilai default atau
modifikasi dari properti.


Instance:GetStyled

selector

Pemilih opsional untuk instance pseudo yang Anda targetkan pada
instance.


Nilai yang telah ditata atau dimodifikasi secara eksplisit dari properti yang ditentukan, atau
nilai properti default jika belum ditata/dimodifikasi.


Mengembalikan nilai yang telah ditata atau dimodifikasi secara eksplisit dari properti yang ditentukan,
atau nilai properti default jika belum ditata/dimodifikasi.


Mendemonstrasikan `Class.Instance:GetStyledPropertyChangedSignal()`.


Metode ini mengembalikan sebuah acara yang berfungsi persis seperti
acara `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`,
akan tetapi hanya dipicu ketika properti gaya yang diberikan berubah. Ini
umumnya adalah ide yang baik untuk menggunakan metode ini alih-alih koneksi ke
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` dengan fungsi yang memeriksa
nama properti. Panggilan berikutnya ke metode ini pada objek yang sama dengan nama
properti yang sama mengembalikan acara yang sama.

Perhatikan bahwa acara ini tidak akan melewatkan argumen ke fungsi yang terhubung,
jadi nilai dari properti yang berubah harus dibaca langsung dalam
skrip.


Instance:GetStyledPropertyChangedSignal

property

Nama properti gaya yang akan didengarkan untuk perubahan.


Acara yang dipicu ketika properti gaya yang diberikan berubah.


Mengembalikan sebuah acara yang dipicu ketika properti gaya yang diberikan berubah pada
instance.


Metode ini mengembalikan array dari tag yang diterapkan pada instance yang diberikan, sebagai
string. Anda dapat menambahkan tag baik di Studio di jendela
[Properties](/studio/properties) atau saat runtime dengan
`Class.Instance:AddTag()|AddTag()`.

Metode ini berguna ketika Anda ingin melakukan sesuatu dengan beberapa tag pada
instance sekaligus. Namun, tidak efisien untuk menggunakan metode ini untuk
memeriksa keberadaan satu tag; sebaliknya, gunakan
`Class.Instance:HasTag()|HasTag()` untuk memeriksa tag tertentu.


Instance:GetTags

Array string, masing-masing mewakili tag yang diterapkan pada instance.


Mengambil array dari semua tag yang diterapkan pada instance.


Metode ini mengembalikan `true` jika tag yang diberikan telah ditambahkan ke
objek. Anda dapat menambahkan tag baik di Studio di jendela
[Properties](/studio/properties) atau saat runtime dengan
`Class.Instance:AddTag()|AddTag()`.


Instance:HasTag

`true` jika instance memiliki tag yang diberikan, `false` jika tidak.


Memeriksa apakah instance memiliki tag tertentu.


Demonstrasikan penentuan apakah satu instance adalah nenek moyang dari yang lain menggunakan
`Class.Instance:IsAncestorOf()`

Workspace dan SpawnLocation adalah nenek moyang dari decal SpawnLocation.
Workspace adalah nenek moyang dari SpawnLocation.

SpawnLocation dan decal-nya adalah keturunan dari Workspace, bukan nenek moyang.
Decal adalah keturunan untuk SpawnLocation, bukan nenek moyang.

Mengembalikan true jika `Class.Instance` adalah nenek moyang dari keturunan yang diberikan.

`Class.Instance` dianggap sebagai nenek moyang dari sebuah objek jika
`Class.Instance.Parent` objek tersebut atau salah satu `Class.Instance.Parent`
-nya diatur ke `Class.Instance`.

Lihat juga, `Class.Instance:IsDescendantOf()`.


Instance:IsAncestorOf

Benar jika `Class.Instance` adalah nenek moyang dari keturunan yang diberikan.


Mengembalikan true jika `Class.Instance` adalah nenek moyang dari keturunan yang diberikan.


Mengembalikan `true` jika `Class.Instance` adalah keturunan dari nenek moyang yang diberikan.

Perhatikan bahwa `IsDescendantOf()` tidak dapat digunakan dengan parameter `nil` untuk
memeriksa apakah objek telah dihapus.

Lihat juga `Class.Instance:IsAncestorOf()`.


Instance:IsDescendantOf

ancestor

Benar jika `Class.Instance` adalah keturunan dari nenek moyang yang diberikan.


Mengembalikan `true` jika `Class.Instance` adalah keturunan dari nenek moyang yang diberikan.


Instance:isDescendantOf

Metode ini menunjukkan apakah properti tertentu telah dimodifikasi dari
default yang diinstansiasi kode. Jika dipanggil pada instance yang baru dibuat melalui
kode (`Datatype.Instance.new()`), metode ini akan mengembalikan `false`. Jika
dipanggil pada objek yang baru dibuat oleh alur kerja Studio seperti
jendela [Explorer](/studio/explorer) penyisipan, hasilnya mungkin
berbeda.

Sebagai contoh, menanyakan properti
`Class.TextLabel.BackgroundColor3|BackgroundColor3` dari
`Class.TextLabel` yang disisipkan melalui jendela [Explorer](/studio/explorer)
akan mengembalikan `true`, tetapi menanyakan properti yang sama dari `Class.TextLabel`
yang dibuat melalui `Datatype.Instance.new()` akan mengembalikan `false`, dengan asumsi tidak
ada perubahan lain yang dilakukan pada
`Class.TextLabel.BackgroundColor3|BackgroundColor3`.

Perhatikan bahwa metode ini hanya mengembalikan hasil yang berguna untuk layanan dan
instance yang dapat dibuat oleh pengguna. Nilai pengembalian untuk properti yang diisi oleh sistem
seperti `Class.PackageLink` adalah perilaku yang tidak terdefinisi.

Juga perhatikan bahwa jika metode ini mengembalikan `true`, penataan **tidak** akan mempengaruhi
properti karena modifikasi eksplisit pada properti memiliki prioritas lebih tinggi daripada
penataan. Untuk mengatur ulang properti ke default yang diinstansiasi kode dan memungkinkan
penataan padanya, gunakan
`Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()`.


Instance:IsPropertyModified

Boolean yang menunjukkan apakah properti dimodifikasi dari
default yang diinstansiasi kode.


Mengembalikan `true` jika nilai yang disimpan dalam properti yang ditentukan tidak sama
dengan default yang diinstansiasi kode.


Metode objek ini mengembalikan array yang berisi semua keturunan dari objek
yang cocok dengan string `selector` yang diberikan. `selector` dapat mencakup
beberapa pemilih dan penggabung untuk mencocokkan karakteristik seperti nama
kelas, nama instance, dan hubungan hierarki, serta nilai spesifik dari
properti dan atribut instance. Tata bahasa `selector`
mirip dengan yang digunakan dalam `Class.StyleRule`, dengan hanya beberapa
differences mengenai bagian mana dari tata bahasa yang didukung atau tidak.

#### Pemilih

- `ClassName` — Mencocokkan instance dari kelas yang ditentukan dalam
  hubungan `Class.Object:IsA()`.
- `.Tag` — Mencocokkan instance yang diberi tag dengan tag `Class.CollectionService`.
- `#Name` — Mencocokkan instance dari `Class.Instance.Name` tertentu.
- `[property = value]` — Mencocokkan instance yang memiliki properti yang ditentukan
  dan bahwa properti tersebut memiliki nilai yang ditentukan. Nilai boolean, angka, dan
  string didukung. Huruf, angka, `_`, dan `-` dapat digunakan
  tanpa menempatkan nilai dalam tanda kutip.
- `[$attribute]` — Mencocokkan instance yang memiliki atribut yang ditentukan
  [atribut](/studio/properties#instance-attributes) yang diatur.
- `[$attribute = value]` — Mencocokkan instance yang memiliki atribut yang ditentukan
  **dan** bahwa atribut tersebut memiliki nilai yang ditentukan. Pembatasan yang sama berlaku
  seperti untuk pemilih properti. Jika Anda ingin memeriksa ketidakhadiran atribut,
jangan kueri sebagai `nil`; sebaliknya gunakan
  kelas pseudo `:not` seperti dalam `:not([$attribute])`.

Pemilih juga dapat digabungkan. Sebagai contoh,
`Model.Apple[$Variety = Fuji][$Flavor = 4]` akan mencocokkan instance yang merupakan
`Class.Model` yang diberi tag sebagai `Apple` dan yang memiliki atribut `Variety`
yang sama dengan `Fuji` serta atribut `Flavor` yang sama dengan `4`.

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

-- Dapatkan semua keturunan MeshPart
print(Workspace:QueryDescendants("MeshPart"))

-- Dapatkan semua keturunan yang diberi tag sebagai "Fruit"
print(Workspace:QueryDescendants(".Fruit"))

-- Dapatkan semua keturunan dengan nama "RedTree"
print(Workspace:QueryDescendants("#RedTree"))

-- Dapatkan semua keturunan dengan properti CanCollide diatur ke false
print(Workspace:QueryDescendants("[CanCollide = false]"))

-- Dapatkan semua keturunan dengan atribut "FuelCapacity" yang ditetapkan
print(Workspace:QueryDescendants("[$FuelCapacity]"))
-- Dapatkan semua keturunan dengan atribut "FuelCapacity" diatur ke 75
print(Workspace:QueryDescendants("[$FuelCapacity = 75]"))
```

#### Penggabung

Penggabung memungkinkan Anda mencampur pemilih dasar untuk mencocokkan hubungan hierarki yang lebih dalam.

- `>` — Mencocokkan instance yang merupakan **anak langsung** dari filter sebelumnya.

- `>>` — Mencocokkan instance yang merupakan **keturunan** dari filter sebelumnya.
  Ini adalah filter pertama default, artinya `SpotLight.Red`
  sama dengan `>> SpotLight.Red`.

- `,` — Menentukan daftar beberapa pemilih independen untuk kueri keturunan.
  Hanya elemen yang cocok dengan filter yang ditempatkan dalam
  array yang dikembalikan; `nil` tidak akan disertakan untuk non-cocok dalam daftar kueri.

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

-- Dapatkan anak langsung dari Model mana pun yang diberi tag sebagai "SwordPart"
print(Workspace:QueryDescendants("Model > .SwordPart"))

-- Dapatkan anak langsung yang merupakan Part dan diberi tag sebagai "Apple"
print(Workspace:QueryDescendants("> Part.Apple"))

-- Dapatkan keturunan dari Model mana pun dengan atribut "OnFire" diatur ke true
print(Workspace:QueryDescendants("Model >> [$OnFire = true]"))

-- Dapatkan keturunan MeshPart yang diberi tag sebagai "SwordPart" ATAU dengan atribut "OnFire" diatur ke true
print(Workspace:QueryDescendants("MeshPart.SwordPart, MeshPart[$OnFire = true]"))
```

#### Pemilih kelas pseudo

- `:not(complex-selector-list)` — Memungkinkan memilih instance yang **tidak**
mencocokkan salah satu pemilih di dalamnya, secara efektif melakukan negasi dari
pemilih. Karena ekspresi di dalamnya adalah daftar pemilih kompleks, dimungkinkan untuk
memfilter berdasarkan beberapa kondisi.

- `:has(relative-selector-list)` — Memungkinkan memilih instance berdasarkan
instance yang mereka miliki di dalamnya. Daftar pemilih dievaluasi
relatif terhadap setiap instance.

- `:in-radius(studs, complex-selector-list)` Memilih instance dalam
jumlah stud yang ditentukan. Daftar pemilih dievaluasi terhadap semua
instance yang cocok dengan kueri. Ini secara efektif mengevaluasi sebuah gabungan.

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

-- Dapatkan semua keturunan yang TIDAK dari kelas SpotLight
print(Workspace:QueryDescendants(":not(SpotLight)"))
-- Dapatkan semua keturunan yang TIDAK dari kelas SpotLight ATAU PointLight
print(Workspace:QueryDescendants(":not(SpotLight, PointLight)"))
-- Dapatkan semua keturunan yang TIDAK memiliki atribut "OnFire"
print(Workspace:QueryDescendants(":not([$OnFire])"))
-- Dapatkan semua keturunan KECUALI anak dari Model yang diberi tag sebagai "SwordPart"
print(Workspace:QueryDescendants(":not(Model > .SwordPart)"))

-- Dapatkan keturunan yang memiliki instance Tool sebagai keturunannya sendiri
print(Workspace:QueryDescendants(":has(Tool)"))
-- Dapatkan keturunan MeshPart yang memiliki anak langsung yang diberi tag sebagai "SwordPart"
print(Workspace:QueryDescendants("MeshPart:has(> .SwordPart)"))

-- Dapatkan keturunan MeshPart dengan anak langsung yang TIDAK dari kelas SurfaceAppearance atau Texture
print(Workspace:QueryDescendants("MeshPart:has(> :not(SurfaceAppearance, Texture))"))

-- Dapatkan Model Fireball dalam radius 10 stud dari HumanoidRootPart (Pemain atau NPC)
print(Workspace:QueryDescendants("Model.FireBall:in-radius(10, Model:has(> Part#HumanoidRootPart))"))
```


Instance:QueryDescendants

String pemilih yang digunakan untuk memfilter elemen.


Array instance (kosong jika tidak ada yang cocok dengan pemilih).


Mengembalikan array yang berisi semua keturunan dari instance yang cocok dengan
string `selector`.


Kode berikut menunjukkan bagaimana suatu bagian dapat ditambahkan kembali ke DataModel setelah dihapus:

Metode ini mengatur `Class.Instance.Parent` objek menjadi `nil`, dan melakukan
hal yang sama untuk semua keturunannya.

Jika objek dirujuk sebelum dihapus, mungkin untuk mengambil objek tersebut di
nanti hari.


Instance:Remove

Mengatur `Parent` objek menjadi `nil`, dan melakukan hal yang sama untuk semua
keturunannya.


Instance:remove

Metode ini menghapus tag dari sebuah instance. Ini tidak akan melempar kesalahan jika
objek tidak memiliki tag. Menghapus tag dengan sukses akan memicu sinyal yang dibuat oleh
`Class.CollectionService:GetInstanceRemovedSignal()` dengan tag yang diberikan.

Perhatikan bahwa saat memberi tag pada instance, umum bahwa beberapa sumber daya digunakan untuk
memberikan fungsionalitas tag, misalnya koneksi acara atau tabel. Untuk mencegah kebocoran memori,
merupakan ide yang baik untuk membersihkannya (putuskan sambungan, atur ke `nil`, dll.) saat tidak lagi
diperlukan untuk tag.


Instance:RemoveTag

Mengatur ulang properti ke nilai defaultnya. Misalnya, memanggil
`ResetPropertyToDefault("Rotation")` pada `Class.TextLabel` setara
dengan mengatur `Class.TextLabel.Rotation|Rotation` ke `0` (nilai
default properti). Metode ini dapat digunakan untuk memastikan gaya akan
mengganti nilai default properti ini.


Instance:ResetPropertyToDefault

Mengatur ulang properti ke nilai defaultnya.


Metode ini mengatur atribut dengan nama yang diberikan ke nilai yang diberikan. Jika
nilai yang diberikan adalah `nil`, atribut akan dihapus, karena `nil`
dikembalikan secara default.

Misalnya, cuplikan kode berikut mengatur atribut `InitialPosition`
dari instance ke `Datatype.Vector3|Vector3.new(0, 10, 0)`:

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

local part = Workspace.Part
part:SetAttribute("InitialPosition", Vector3.new(0, 10, 0))
```

#### Pembatasan

Persyaratan dan pembatasan penamaan:

- Nama hanya boleh menggunakan karakter alfanumerik.
  - Anda juga dapat menyertakan titik, tanda hubung, garis miring, dan garis bawah.
- Tidak ada spasi atau simbol unik (seperti @, ~, !) yang diperbolehkan.
- String harus 100 karakter atau kurang.
- Nama tidak boleh diawali dengan **RBX** kecuali pemanggil adalah
  skrip inti Roblox (dikhususkan untuk Roblox).

Saat mencoba mengatur atribut ke tipe yang tidak didukung, akan
terjadi kesalahan.

#### Lihat Juga

- `Class.Instance:GetAttribute()` yang mengembalikan nilai yang telah
  ditetapkan untuk nama atribut yang diberikan.
- `Class.Instance:GetAttributes()` yang mengembalikan kamus pasangan kunci-nilai
  untuk setiap atribut instance.


Instance:SetAttribute

value

Nilai untuk mengatur atribut yang ditentukan.


Mengatur atribut dengan nama yang diberikan ke nilai yang diberikan.


Kode berikut menunggu sebuah instance bernama "Part" untuk ditambahkan ke
Workspace.


Mengembalikan anak dari `Class.Instance` dengan nama yang diberikan. Jika
anak tersebut tidak ada, akan menunggu thread saat ini hingga ada. Jika
parameter `timeOut` ditentukan, metode ini akan timeout setelah
jumlah detik yang ditentukan dan mengembalikan `nil`.

#### Penggunaan Utama

`Class.Instance:WaitForChild()|WaitForChild()` sangat penting saat
bekerja pada kode yang dijalankan oleh klien dalam `Class.LocalScript`. Mesin
Roblox tidak menjamin waktu atau urutan di mana objek direplikasi dari
server ke klien. Selain itu, jika sebuah pengalaman memiliki
`Class.Workspace.StreamingEnabled` diatur ke true,
`Class.BasePart|BaseParts` yang jauh dari karakter pemain
mungkin tidak disiarkan ke klien, yang dapat menyebabkan skrip
bermasalah saat mengindeks objek yang belum ada di klien.

#### Catatan

- Metode ini tidak menunggu jika anak dengan nama yang diberikan ada saat
  panggilan dilakukan.
- `Class.Instance:FindFirstChild()` adalah alternatif yang lebih efisien untuk
  `Class.Instance:WaitForChild()|WaitForChild()` untuk objek yang diasumsikan
  ada.
- Jika panggilan ke metode ini melebihi 5 detik tanpa mengembalikan, dan tidak ada
  parameter `timeOut` yang ditentukan, peringatan akan dicetak ke
  output bahwa thread mungkin menunggu tanpa batas.


Instance:WaitForChild

childName

timeOut

Mengembalikan anak dari `Class.Instance` dengan nama yang diberikan. Jika
anak tersebut tidak ada, akan menunggu thread saat ini hingga ada.


Instance

Menunjukkan `Class.Instance.Archivable`.


Properti ini menentukan apakah instance harus disertakan saat
pengalaman dipublikasikan atau disimpan, atau saat `Class.Instance:Clone()|Clone()`
dipanggil pada salah satu nenek moyang instance. Memanggil
`Class.Instance:Clone()|Clone()` secara langsung pada instance akan mengembalikan `nil`
jika instance tersebut **tidak** `Class.Instance.Archivable|Archivable`.

Menyalin objek di Studio menggunakan opsi **Duplicate** atau **Copy**/**Paste**
akan mengabaikan properti `Class.Instance.Archivable|Archivable` miliknya sendiri
dan mengatur `Class.Instance.Archivable|Archivable` menjadi `true` untuk salinan tersebut.


Instance.Archivable

Menentukan apakah `Class.Instance` dan keturunannya dapat disalin menggunakan
`Class.Instance:Clone()`, dan dapat disimpan/dipublikasikan.


`Instance` adalah kelas dasar untuk semua kelas dalam hierarki kelas Roblox
yang dapat menjadi bagian dari pohon `Class.DataModel`.


/reference/engine/classes/IntegrityService.yaml

Ringkasan