python - unittest.mock.patch の (文書化されていない) return_value 引数はどのように機能しますか?

Question

unittest.mock.patch()および引数をunittest.mock.patch.object()直接使用する例を見てきました。return_value

例：

with patch.object(ProductionClass, 'method', return_value=None) as mock_method:
    thing = ProductionClass()
    thing.method(1, 2, 3)

ただし、この引数は、unittest.mock.patch()norについて公式に文書化されていませんunittest.mock.patch.object()。(ただし、公式ドキュメントの例では使用されています)。

これはサポートされていますか、それとも未定義の動作ですか? それは文書化されるはずですか、そうではありませんか？これらの例は偶然に機能しますか? この引数は何をしますか。それは直感的でないことをしますか、それとも自明ですか？