# wp_send_json_error()

URL: https://chugunov.pro/api-wordpress/functions/wp_send_json_error/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 3.5.0.

## Сигнатура

```php
wp_send_json_error( mixed $value = null, int $status_code = null, int $flags )
```

## Описание

Если параметр $value является объектом WP_Error, ошибки внутри объекта обрабатываются и выводятся в виде массива кодов ошибок и соответствующих сообщений. Все остальные типы выводятся без дополнительной обработки.

## Параметры

- `$value` `mixed` — необязательный, по умолчанию `null`. Данные для кодирования в JSON, последующего вывода и завершения.
- `$status_code` `int` — необязательный, по умолчанию `null`. Код состояния HTTP для вывода.
- `$flags` `int` — необязательный. Опции, передаваемые в json_encode(). Значение по умолчанию 0.

## Исходный код

Файл: `wp-includes/functions.php:4614`

```php
function wp_send_json_error( $value = null, $status_code = null, $flags = 0 ) {
	$response = array( 'success' => false );

	if ( isset( $value ) ) {
		if ( is_wp_error( $value ) ) {
			$result = array();
			foreach ( $value->errors as $code => $messages ) {
				foreach ( $messages as $message ) {
					$result[] = array(
						'code'    => $code,
						'message' => $message,
					);
				}
			}

			$response['data'] = $result;
		} else {
			$response['data'] = $value;
		}
	}

	wp_send_json( $response, $status_code, $flags );
}
```

## История изменений

- 5.6.0 — The $flags parameter was added.
- 4.7.0 — The $status_code parameter was added.
- 4.1.0 — The $value parameter is now processed if a WP_Error object is passed in.
- 3.5.0 — Introduced.

## Связанные

Использует: [`wp_send_json`](https://chugunov.pro/api-wordpress/functions/wp_send_json/), [`is_wp_error`](https://chugunov.pro/api-wordpress/functions/is_wp_error/).
Используется в: `WP_Plugin_Dependencies::check_plugin_dependencies_during_ajax`, [`wp_ajax_activate_plugin`](https://chugunov.pro/api-wordpress/functions/wp_ajax_activate_plugin/), [`locate_block_template`](https://chugunov.pro/api-wordpress/functions/locate_block_template/), [`wp_ajax_send_password_reset`](https://chugunov.pro/api-wordpress/functions/wp_ajax_send_password_reset/), [`wp_ajax_toggle_auto_updates`](https://chugunov.pro/api-wordpress/functions/wp_ajax_toggle_auto_updates/), [`wp_ajax_media_create_image_subsizes`](https://chugunov.pro/api-wordpress/functions/wp_ajax_media_create_image_subsizes/), [`wp_ajax_health_check_get_sizes`](https://chugunov.pro/api-wordpress/functions/wp_ajax_health_check_get_sizes/), [`wp_ajax_health_check_dotorg_communication`](https://chugunov.pro/api-wordpress/functions/wp_ajax_health_check_dotorg_communication/), [`wp_ajax_health_check_background_updates`](https://chugunov.pro/api-wordpress/functions/wp_ajax_health_check_background_updates/), [`wp_ajax_health_check_loopback_requests`](https://chugunov.pro/api-wordpress/functions/wp_ajax_health_check_loopback_requests/), [`wp_ajax_health_check_site_status_result`](https://chugunov.pro/api-wordpress/functions/wp_ajax_health_check_site_status_result/), [`wp_privacy_process_personal_data_export_page`](https://chugunov.pro/api-wordpress/functions/wp_privacy_process_personal_data_export_page/), [`wp_privacy_generate_personal_data_export_file`](https://chugunov.pro/api-wordpress/functions/wp_privacy_generate_personal_data_export_file/), [`wp_privacy_process_personal_data_erasure_page`](https://chugunov.pro/api-wordpress/functions/wp_privacy_process_personal_data_erasure_page/), [`wp_ajax_wp_privacy_export_personal_data`](https://chugunov.pro/api-wordpress/functions/wp_ajax_wp_privacy_export_personal_data/), [`wp_ajax_wp_privacy_erase_personal_data`](https://chugunov.pro/api-wordpress/functions/wp_ajax_wp_privacy_erase_personal_data/), `WP_Customize_Manager::handle_load_themes_request`, `WP_Customize_Manager::handle_override_changeset_lock_request`, `WP_Customize_Manager::handle_dismiss_autosave_or_lock_request`, `WP_Customize_Manager::handle_changeset_trash_request`, [`wp_ajax_edit_theme_plugin_file`](https://chugunov.pro/api-wordpress/functions/wp_ajax_edit_theme_plugin_file/), [`wp_ajax_get_community_events`](https://chugunov.pro/api-wordpress/functions/wp_ajax_get_community_events/), `WP_Customize_Nav_Menus::ajax_insert_auto_draft_post`, [`wp_ajax_search_install_plugins`](https://chugunov.pro/api-wordpress/functions/wp_ajax_search_install_plugins/), [`wp_ajax_delete_plugin`](https://chugunov.pro/api-wordpress/functions/wp_ajax_delete_plugin/), [`wp_ajax_search_plugins`](https://chugunov.pro/api-wordpress/functions/wp_ajax_search_plugins/), [`wp_ajax_install_theme`](https://chugunov.pro/api-wordpress/functions/wp_ajax_install_theme/), [`wp_ajax_update_theme`](https://chugunov.pro/api-wordpress/functions/wp_ajax_update_theme/), [`wp_ajax_delete_theme`](https://chugunov.pro/api-wordpress/functions/wp_ajax_delete_theme/), [`wp_ajax_install_plugin`](https://chugunov.pro/api-wordpress/functions/wp_ajax_install_plugin/), `WP_Customize_Selective_Refresh::handle_render_partials_request`, [`wp_ajax_save_wporg_username`](https://chugunov.pro/api-wordpress/functions/wp_ajax_save_wporg_username/), `WP_Customize_Nav_Menus::ajax_load_available_items`, `WP_Customize_Nav_Menus::ajax_search_available_items`, [`wp_ajax_crop_image`](https://chugunov.pro/api-wordpress/functions/wp_ajax_crop_image/), `WP_Customize_Manager::refresh_nonces`, [`wp_ajax_press_this_add_category`](https://chugunov.pro/api-wordpress/functions/wp_ajax_press_this_add_category/), [`wp_ajax_update_plugin`](https://chugunov.pro/api-wordpress/functions/wp_ajax_update_plugin/), [`wp_ajax_press_this_save_post`](https://chugunov.pro/api-wordpress/functions/wp_ajax_press_this_save_post/), [`wp_ajax_destroy_sessions`](https://chugunov.pro/api-wordpress/functions/wp_ajax_destroy_sessions/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/wp_send_json_error/