locateCenterOnScreen doesn't raise ImageNotFoundException.

[falconws]

pyautogui.locateCenterOnScreen method doesn't raise ImageNotFoundException.
This method returns None.
I'm reading this.
https://pyautogui.readthedocs.io/en/latest/screenshot.html#the-locate-functions
Why this method returning None instead of raising ImageNotFoundException?
pyautogui.locateOnScreen also same returns None.

>>> test = pyautogui.locateCenterOnScreen('not_found.png')
>>> test
>>> test == None
True
>>> 

Version: PyAutoGUI==0.9.50
OS: Linux mint MATE 19.3

$ python -V
Python 3.6.9

[copyrite]

I'm experiencing the same problem. locateOnScreen seems to be also affected.

• PyAutoGUI version 0.9.50
• PyScreeze 0.1.26
• Python 3.7.4

[copyrite]

I guess this is it.

pyautogui/pyautogui/__init__.py

Lines 263 to 277 in 57a98be

	def useImageNotFoundException(value=None):
	"""
	When called with no arguments, PyAutoGUI will raise ImageNotFoundException when the PyScreeze locate*() functions
	can't find the image it was told to locate. The default behavior is to return None. Call this function with no
	arguments (or with True as the argument) to have exceptions raised, which is a better practice.
	You can also disable raising exceptions by passing False for the argument.
	"""
	if value is None:
	value = True
	# TODO - this will cause a NameError if PyScreeze couldn't be imported:
	try:
	pyscreeze.USE_IMAGE_NOT_FOUND_EXCEPTION = value
	except NameError:
	raise PyAutoGUIException("useImageNotFoundException() ws called but pyscreeze isn't installed.")

From the looks of it PyAutoGUI never explicitly calls it, so it is left to user code or PyScreeze. This should really be reflected in the documentation, but in the meantime calling that function near imports should do it.

[LukeSavefrogs]

I guess this is it.

pyautogui/pyautogui/__init__.py

Lines 263 to 277 in 57a98be

	def useImageNotFoundException(value=None):
	"""
	When called with no arguments, PyAutoGUI will raise ImageNotFoundException when the PyScreeze locate*() functions
	can't find the image it was told to locate. The default behavior is to return None. Call this function with no
	arguments (or with True as the argument) to have exceptions raised, which is a better practice.
	You can also disable raising exceptions by passing False for the argument.
	"""
	if value is None:
	value = True
	# TODO - this will cause a NameError if PyScreeze couldn't be imported:
	try:
	pyscreeze.USE_IMAGE_NOT_FOUND_EXCEPTION = value
	except NameError:
	raise PyAutoGUIException("useImageNotFoundException() ws called but pyscreeze isn't installed.")

From the looks of it PyAutoGUI never explicitly calls it, so it is left to user code or PyScreeze. This should really be reflected in the documentation, but in the meantime calling that function near imports should do it.

Thanks. This explains a lot. 😄