【Python】hasattrとは？使い方や引数の意味、活用時の注意点までわかりやすく解説

2025年10月8日 2025年10月8日

Pythonには、オブジェクトが特定の属性（メソッドやプロパティなど）を持っているかどうかを確認するための便利な組み込み関数 hasattr() があります。

この関数は、Pythonらしい「動的で柔軟なコード」を書くために非常によく使われます。

この記事では、hasattr の基本的な使い方から、引数の意味、活用方法、注意点までを初心者向けに丁寧に解説します。

hasattrとは？

hasattr() は、あるオブジェクトに特定の「属性」が存在するかを調べるためのPythonの組み込み関数です。

この関数を使うことで、エラーを防ぎながら安全に属性アクセスができるようになります。

hasattr(object, name)

1 2	hasattr(object, name)

object：属性を確認したい対象のオブジェクト
name：文字列で指定する属性名（例："name" や "upper"）

返り値は True または False で、属性が存在すれば True、存在しなければ False を返します。

基本的な使い方

まずはシンプルな例から見てみましょう。

class User:
    def __init__(self, name):
        self.name = name

user = User("Alice")

print(hasattr(user, "name"))      # True
print(hasattr(user, "email"))     # False

class User:

def __init__(self, name):

self.name = name

user = User("Alice")

print(hasattr(user, "name")) # True

print(hasattr(user, "email")) # False

この例では：

User クラスのインスタンス user は name 属性を持っているため、hasattr(user, "name") は True
email という属性は定義されていないため、hasattr(user, "email") は False

つまり、存在しない属性にアクセスして AttributeError を出す前に、安全に確認できるのが hasattr の役割です。

具体例：属性があるかで処理を分ける

hasattr() は条件分岐の中でよく使われます。

def print_name(obj):
    if hasattr(obj, "name"):
        print(f"Name is: {obj.name}")
    else:
        print("No name attribute.")

class User:
    def __init__(self, name):
        self.name = name

class Anonymous:
    pass

print_name(User("Alice"))     # Name is: Alice
print_name(Anonymous())       # No name attribute.

def print_name(obj):

if hasattr(obj, "name"):

print(f"Name is: {obj.name}")

else:

print("No name attribute.")

class User:

def __init__(self, name):

self.name = name

class Anonymous:

pass

print_name(User("Alice")) # Name is: Alice

print_name(Anonymous()) # No name attribute.

【コードのポイント】

hasattr(obj, "name") で、オブジェクトが name 属性を持っているかを確認。
属性がある場合は obj.name の値を表示し、ない場合は「No name attribute.」と出力する。
User クラスは name 属性を持つため「Name is: Alice」と表示される。
Anonymous クラスは name 属性を持たないため「No name attribute.」と表示される。

このように、オブジェクトに name 属性があるかどうかで、処理を柔軟に変えることができます。

特に、様々な種類のオブジェクトを受け取る関数や、プラグイン的なコードではよく使われます。

具体例：メソッドの存在確認

属性には「メソッド（関数）」も含まれます。

したがって、hasattr() で「このメソッドがあるなら呼び出す」といった柔軟な処理が可能です。

class PluginA:
    def run(self):
        print("PluginA is running")

class PluginB:
    pass

for plugin in [PluginA(), PluginB()]:
    if hasattr(plugin, "run"):
        plugin.run()
    else:
        print("No run method")

class PluginA:

def run(self):

print("PluginA is running")

class PluginB:

pass

for plugin in [PluginA(), PluginB()]:

if hasattr(plugin, "run"):

plugin.run()

else:

print("No run method")

【コードのポイント】

hasattr(plugin, "run") で、オブジェクトが run というメソッドを持っているかを確認している。
PluginA クラスは run() メソッドを持つため、plugin.run() が実行され「PluginA is running」と出力される。
PluginB クラスは run() メソッドを持たないため、「No run method」と表示される。
メソッドも属性の一種として扱われるため、hasattr() で 関数の存在チェック も可能。

これにより、「存在するメソッドだけを安全に呼び出す」という柔軟な処理が実現できます。

プラグインシステムなど、実装内容が異なる複数クラスを一括で処理する設計に有効なパターンです。

注意点まとめ

hasattr() は便利な関数ですが、いくつかの落とし穴があります。

使う際は次の点に注意しましょう。

スペルミスしてもエラーにならない
属性名を文字列で指定するため、"nmae" のようにタイプミスしても False が返るだけでエラーになりません。
→ 定数化やIDEの補完機能を活用して防止しましょう。
内部属性も検出される
__class__ や __dict__ など、Pythonの内部的な属性も True になります。
→ ユーザー定義の属性だけを確認したい場合は、"name" in obj.__dict__ のように確認するのが確実です。
プロパティや __getattr__ に注意
hasattr() は、実際にその属性へアクセスして「あるかどうか」を確認します。
そのため、属性が プロパティ（@property） や __getattr__() で定義されている場合、hasattr() を呼んだだけで、その中の処理が実行されてしまうことがあります。