Items · lua · 看云

These functions operate on item links or item information directly. See also[Bag](https://wow.gamepedia.com/World_of_Warcraft_API#Bags)functions. [C\_Item.CanViewItemPowers](https://wow.gamepedia.com/API_C_Item.CanViewItemPowers "API C Item.CanViewItemPowers")(itemLoc) [C\_Item.DoesItemExist](https://wow.gamepedia.com/API_C_Item.DoesItemExist "API C Item.DoesItemExist")(emptiableItemLocation) [C\_Item.DoesItemExistByID](https://wow.gamepedia.com/API_C_Item.DoesItemExistByID "API C Item.DoesItemExistByID")("itemInfo") [C\_Item.GetCurrentItemLevel](https://wow.gamepedia.com/API_C_Item.GetCurrentItemLevel "API C Item.GetCurrentItemLevel")(itemLocation) [C\_Item.GetItemGUID](https://wow.gamepedia.com/API_C_Item.GetItemGUID "API C Item.GetItemGUID")(itemLocation) [C\_Item.GetItemID](https://wow.gamepedia.com/API_C_Item.GetItemID "API C Item.GetItemID")(itemLocation) [C\_Item.GetItemIcon](https://wow.gamepedia.com/API_C_Item.GetItemIcon "API C Item.GetItemIcon")(itemLocation) [C\_Item.GetItemIconByID](https://wow.gamepedia.com/API_C_Item.GetItemIconByID "API C Item.GetItemIconByID")("itemInfo") [C\_Item.GetItemInventoryType](https://wow.gamepedia.com/API_C_Item.GetItemInventoryType "API C Item.GetItemInventoryType")(itemLocation) [C\_Item.GetItemInventoryTypeByID](https://wow.gamepedia.com/API_C_Item.GetItemInventoryTypeByID "API C Item.GetItemInventoryTypeByID")("itemInfo") [C\_Item.GetItemLink](https://wow.gamepedia.com/API_C_Item.GetItemLink "API C Item.GetItemLink")(itemLocation) [C\_Item.GetItemName](https://wow.gamepedia.com/API_C_Item.GetItemName "API C Item.GetItemName")(itemLocation) [C\_Item.GetItemNameByID](https://wow.gamepedia.com/API_C_Item.GetItemNameByID "API C Item.GetItemNameByID")("itemInfo") [C\_Item.GetItemQuality](https://wow.gamepedia.com/API_C_Item.GetItemQuality "API C Item.GetItemQuality")(itemLocation) [C\_Item.GetItemQualityByID](https://wow.gamepedia.com/API_C_Item.GetItemQualityByID "API C Item.GetItemQualityByID")("itemInfo") [C\_Item.IsBound](https://wow.gamepedia.com/API_C_Item.IsBound "API C Item.IsBound")(itemLocation) [C\_Item.IsItemDataCachedByID](https://wow.gamepedia.com/API_C_Item.IsItemDataCachedByID "API C Item.IsItemDataCachedByID")("itemInfo") [C\_Item.IsItemDataCached](https://wow.gamepedia.com/API_C_Item.IsItemDataCached "API C Item.IsItemDataCached")(itemLocation) [C\_Item.IsLocked](https://wow.gamepedia.com/API_C_Item.IsLocked "API C Item.IsLocked")(itemLocation) [C\_Item.LockItem](https://wow.gamepedia.com/API_C_Item.LockItem "API C Item.LockItem")(itemLocation) [C\_Item.RequestLoadItemData](https://wow.gamepedia.com/API_C_Item.RequestLoadItemData "API C Item.RequestLoadItemData")(itemLocation) [C\_Item.RequestLoadItemDataByID](https://wow.gamepedia.com/API_C_Item.RequestLoadItemDataByID "API C Item.RequestLoadItemDataByID")("itemInfo") [C\_Item.UnlockItem](https://wow.gamepedia.com/API_C_Item.UnlockItem "API C Item.UnlockItem")(itemLocation) [C\_ItemUpgrade.GetItemHyperlink](https://wow.gamepedia.com/API_C_ItemUpgrade.GetItemHyperlink "API C ItemUpgrade.GetItemHyperlink")() [C\_NewItems.ClearAll](https://wow.gamepedia.com/API_C_NewItems.ClearAll "API C NewItems.ClearAll")() - Clears the new item flag on all items in the player's inventory. [C\_NewItems.IsNewItem](https://wow.gamepedia.com/API_C_NewItems.IsNewItem "API C NewItems.IsNewItem")(bag, slot) - Returns whether the item in the specified container slot is flagged as new. [C\_NewItems.RemoveNewItem](https://wow.gamepedia.com/API_C_NewItems.RemoveNewItem "API C NewItems.RemoveNewItem")(bag, slot) - Clears the "new item" flag. [ActionBindsItem](https://wow.gamepedia.com/index.php?title=API_ActionBindsItem&action=edit&redlink=1 "API ActionBindsItem (page does not exist)")() - Confirms this will bind this item to you. [ClearItemUpgrade](https://wow.gamepedia.com/index.php?title=API_ClearItemUpgrade&action=edit&redlink=1 "API ClearItemUpgrade (page does not exist)")() [CloseItemUpgrade](https://wow.gamepedia.com/index.php?title=API_CloseItemUpgrade&action=edit&redlink=1 "API CloseItemUpgrade (page does not exist)")() [ConfirmOnUse](https://wow.gamepedia.com/index.php?title=API_ConfirmOnUse&action=edit&redlink=1 "API ConfirmOnUse (page does not exist)")() - Confirms you want to use the item. [EndBoundTradeable](https://wow.gamepedia.com/index.php?title=API_EndBoundTradeable&action=edit&redlink=1 "API EndBoundTradeable (page does not exist)")("type") - Confirms this will make this item non-tradeable. [EndRefund](https://wow.gamepedia.com/index.php?title=API_EndRefund&action=edit&redlink=1 "API EndRefund (page does not exist)")() - Confirms this will make this item non-refundable. Unused in FrameXML. [EquipItemByName](https://wow.gamepedia.com/API_EquipItemByName "API EquipItemByName")(itemId or "itemName" or "itemLink"\[, invSlot\]) - Equips an item, optionally into a specified slot. [GetDetailedItemLevelInfo](https://wow.gamepedia.com/API_GetDetailedItemLevelInfo "API GetDetailedItemLevelInfo")(itemId or "itemName" or "itemLink") - Returns an item's item level. [GetItemChildInfo](https://wow.gamepedia.com/index.php?title=API_GetItemChildInfo&action=edit&redlink=1 "API GetItemChildInfo (page does not exist)")(itemID|"name"|"itemlink" \[, slotID\]) [GetItemClassInfo](https://wow.gamepedia.com/API_GetItemClassInfo "API GetItemClassInfo")(itemClassID) - Returns the name of the item type. [GetItemCooldown](https://wow.gamepedia.com/API_GetItemCooldown "API GetItemCooldown")(itemId) - Returns startTime, duration, enable. [GetItemCount](https://wow.gamepedia.com/API_GetItemCount "API GetItemCount")(itemId or "itemName" or "itemLink"\[, includeBank\]\[, includeCharges\]) - Returns number of such items in inventory\[, or charges instead if it has charges\]. [GetItemCreationContext](https://wow.gamepedia.com/index.php?title=API_GetItemCreationContext&action=edit&redlink=1 "API GetItemCreationContext (page does not exist)")(|"itemlink") [GetItemFamily](https://wow.gamepedia.com/API_GetItemFamily "API GetItemFamily")(itemId or "itemName" or "itemLink") - Returns the bag type that an item can go into, or for bags the type of items that it can contain. [GetItemGem](https://wow.gamepedia.com/API_GetItemGem "API GetItemGem")("name"|"itemlink", index) [GetItemIcon](https://wow.gamepedia.com/API_GetItemIcon "API GetItemIcon")(itemId) - Returns the icon for the item. Works for any valid item even if it's not in the cache. [GetItemInfo](https://wow.gamepedia.com/API_GetItemInfo "API GetItemInfo")(itemId or "itemString" or "itemName" or "itemLink") - Returns information about an item. [GetItemInfoInstant](https://wow.gamepedia.com/API_GetItemInfoInstant "API GetItemInfoInstant")(itemId or "itemString" or "itemName" or "itemLink") - Returns basic information about an item. [GetItemInventorySlotInfo](https://wow.gamepedia.com/index.php?title=API_GetItemInventorySlotInfo&action=edit&redlink=1 "API GetItemInventorySlotInfo (page does not exist)")(inventorySlot) [GetItemLevelColor](https://wow.gamepedia.com/index.php?title=API_GetItemLevelColor&action=edit&redlink=1 "API GetItemLevelColor (page does not exist)")() [GetItemLevelIncrement](https://wow.gamepedia.com/API_GetItemLevelIncrement "API GetItemLevelIncrement")() [GetItemQualityColor](https://wow.gamepedia.com/API_GetItemQualityColor "API GetItemQualityColor")(quality) - Returns the RGB color codes for a quality. [GetItemSetInfo](https://wow.gamepedia.com/index.php?title=API_GetItemSetInfo&action=edit&redlink=1 "API GetItemSetInfo (page does not exist)")(setID) [GetItemSpecInfo](https://wow.gamepedia.com/API_GetItemSpecInfo "API GetItemSpecInfo")(itemInstance.itemID|"name"|"itemlink"\[, specTable\]) [GetItemSpell](https://wow.gamepedia.com/API_GetItemSpell "API GetItemSpell")(item) - Returns name, rank. [GetItemStatDelta](https://wow.gamepedia.com/index.php?title=API_GetItemStatDelta&action=edit&redlink=1 "API GetItemStatDelta (page does not exist)")(itemLink1, itemLink2\[, statTable\]) [GetItemStats](https://wow.gamepedia.com/API_GetItemStats "API GetItemStats")(itemLink, statTable) - Returns a table of stats for an item. [GetItemSubClassInfo](https://wow.gamepedia.com/API_GetItemSubClassInfo "API GetItemSubClassInfo")(itemClassID, itemSubClassID) - Returns the name of the item subtype. [GetItemUniqueness](https://wow.gamepedia.com/index.php?title=API_GetItemUniqueness&action=edit&redlink=1 "API GetItemUniqueness (page does not exist)")(itemID|"name"|"itemlink") [GetItemUpdateLevel](https://wow.gamepedia.com/API_GetItemUpdateLevel "API GetItemUpdateLevel")() [GetItemUpgradeEffect](https://wow.gamepedia.com/API_GetItemUpgradeEffect "API GetItemUpgradeEffect")(index) [GetItemUpgradeItemInfo](https://wow.gamepedia.com/index.php?title=API_GetItemUpgradeItemInfo&action=edit&redlink=1 "API GetItemUpgradeItemInfo (page does not exist)")() [GetItemUpgradeStats](https://wow.gamepedia.com/index.php?title=API_GetItemUpgradeStats&action=edit&redlink=1 "API GetItemUpgradeStats (page does not exist)")(upgraded) [GetNumItemUpgradeEffects](https://wow.gamepedia.com/API_GetNumItemUpgradeEffects "API GetNumItemUpgradeEffects")() [IsBattlePayItem](https://wow.gamepedia.com/API_IsBattlePayItem "API IsBattlePayItem")(bag, slot) [IsConsumableItem](https://wow.gamepedia.com/API_IsConsumableItem "API IsConsumableItem")(item) [IsCurrentItem](https://wow.gamepedia.com/index.php?title=API_IsCurrentItem&action=edit&redlink=1 "API IsCurrentItem (page does not exist)")(item) [IsDressableItem](https://wow.gamepedia.com/index.php?title=API_IsDressableItem&action=edit&redlink=1 "API IsDressableItem (page does not exist)")(item) - Returns if the item can be shown in the[Dressing room](https://wow.gamepedia.com/Dressing_room "Dressing room"). [IsEquippableItem](https://wow.gamepedia.com/API_IsEquippableItem "API IsEquippableItem")(itemId or "itemName" or "itemLink") - Returns whether an item can be equipped. [IsEquippedItemType](https://wow.gamepedia.com/API_IsEquippedItemType "API IsEquippedItemType")("type") - Where "type" is any valid inventory type, item class, or item subclass. [IsEquippedItem](https://wow.gamepedia.com/API_IsEquippedItem "API IsEquippedItem")(item) [IsHarmfulItem](https://wow.gamepedia.com/index.php?title=API_IsHarmfulItem&action=edit&redlink=1 "API IsHarmfulItem (page does not exist)")(item) - Returns whether an item can be used against hostile units [IsHelpfulItem](https://wow.gamepedia.com/index.php?title=API_IsHelpfulItem&action=edit&redlink=1 "API IsHelpfulItem (page does not exist)")(item) - Returns whether an item can be used on the player or friendly units [IsItemInRange](https://wow.gamepedia.com/API_IsItemInRange "API IsItemInRange")("itemName" or "itemLink", "unit") - Nil for invalid target, false for out of range, true for in range. [IsUsableItem](https://wow.gamepedia.com/index.php?title=API_IsUsableItem&action=edit&redlink=1 "API IsUsableItem (page does not exist)")(item) - Returns usable, noMana. [ItemHasRange](https://wow.gamepedia.com/index.php?title=API_ItemHasRange&action=edit&redlink=1 "API ItemHasRange (page does not exist)")(item) [UpgradeItem](https://wow.gamepedia.com/index.php?title=API_UpgradeItem&action=edit&redlink=1 "API UpgradeItem (page does not exist)")() PROTECTED[UseItemByName](https://wow.gamepedia.com/API_UseItemByName "API UseItemByName")("itemName", "unit") - Use an item on the unit specified.